Back to Trending
RepositoryDartITItaly
SandroMaglione

SandroMaglione/step-progress-indicator

Open source Flutter package, bar indicator made of a series of selected and unselected steps

165stars
36forks
14issues
1views

📊 Step Progress Indicator — Thanh tiến trình từng bước cho Flutter

Widget tiến trình dạng bước (step) linh hoạt, hỗ trợ 3 layout: ngang, dọc, tròn — chỉ vài dòng code.

Step Progress Indicator là package Flutter mã nguồn mở của Sandro Maglione, cung cấp widget StepProgressIndicator để hiển thị tiến trình qua một chuỗi các bước (steps) đã chọn và chưa chọn. Thay vì thanh tiến trình liên tục truyền thống, nó chia tiến trình thành các đoạn rời rạc — phù hợp cho quy trình onboarding, wizard nhiều bước, theo dõi trạng thái đơn hàng, hoặc bất kỳ luồng nào có số trạng thái cố định. Package hỗ trợ null safety từ v1.0.0, tương thích Flutter 2.8+ và Dart 2.15+.

✨ Điểm nổi bật

  • 3 chế độ layout: ngang (horizontal), dọc (vertical), tròn (circular) — cùng một widget, đổi tham số direction/type.
  • Tùy biến số bước: totalSteps (tổng số bước) và currentStep (bước hiện tại) — điều khiển tiến trình dễ dàng.
  • Màu sắc linh hoạt: selectedColor cho bước đã hoàn thành, unselectedColor cho bước chưa đến — nhận mọi Color của Flutter.
  • Kích thước điều chỉnh: tham số size kiểm soát chiều cao (layout ngang/dọc) hoặc bán kính (layout tròn).
  • Bộ đệm & bo góc: padding, borderRadius, strokeWidth (cho circular) tinh chỉnh giao diện chi tiết.
  • Animation mượt: chuyển đổi giữa các bước có animation mặc định, không cần cấu hình thêm.
  • Ví dụ đầy đủ: repo kèm thư mục example demo 4 biến thể linear bar và 2 biến thể circular.
  • Tài liệu dartdoc: tài liệu API chính thức trên pub.dev, có hướng dẫn chi tiết trên blog tác giả.

💡 Vì sao đáng chú ý

Khác với LinearProgressIndicator/CircularProgressIndicator của Flutter core chỉ hiển thị phần trăm liên tục, Step Progress Indicator mô hình hóa tiến trình rời rạc — đúng ngữ nghĩa của các quy trình nhiều giai đoạn (đăng ký 3 bước, checkout 4 bước, onboarding 5 màn hình). API cực gọn: một widget, vài tham sốnamed, không boilerplate. Layout circular là điểm thêm giá trị — hiếm thấy package nào gộp cả 3 dạng trong một API thống nhất. Phù hợp cho team cần UI tiến trình rõ ràng, người dùng nhìn thấy được "bước nào trong tổng số bao nhiêu" thay vì chỉ thấy một thanh đầy dần.


#Flutter #ProgressIndicator #UIComponents #Dart #TiniX

Similar Projects

Discover other similar projects and AI models.

RepositoryDart
CarGuo/gsy_github_app_flutter

Flutter 超完整的开源项目,功能丰富,适合学习和日常使用。GSYGithubApp 系列的优势:我们目前已经拥有 Flutter、Weex、ReactNative、Kotlin View、Kotlin Jetpack Compose ,Compose MultiPlatform,Harmony ArkUI 七个版本,功能齐全,项目框架内技术涉及面广,完成度高,持续维护,配套文章,适合全面学习,对比参考。

15.5k
Oct 25, 2026
RepositoryDart
BirjuVachhani/adaptive_theme

Easiest way to add support for light and dark theme in your flutter app.

685
Aug 14, 2026
RepositoryDart
letsar/overflow_view

A widget displaying children in a line until there is not enough space and showing a the number of children not rendered.

182
Nov 11, 2026
RepositoryDart
felangel/bloc

A predictable state management library that helps implement the BLoC design pattern

12.5k
Nov 14, 2026
RepositoryDart
imaNNeo/fl_chart

FL Chart is a highly customizable Flutter chart library that supports Line Chart, Bar Chart, Pie Chart, Scatter Chart, Radar Chart and Candlestick Chart.

7.6k
Nov 14, 2026
RepositoryDart
duobaseio/forui

Duobase's Flutter UI library

2.4k
Nov 15, 2026
RepositoryDart
AppFlowy-IO/appflowy-editor

A highly customizable rich-text editor for Flutter. The AppFlowy Editor project for AppFlowy and beyond.

694
Aug 6, 2026
RepositoryDart
frideosapps/frideos_flutter

An all-in-one Fllutter package for state management, reactive objects, animations, effects, timed widgets etc.

187
Nov 22, 2023
RepositoryDart
AbdullahChauhan/custom-dropdown

Highly customizable animated Flutter dropdown — search, network search with infinite scroll, multi-select & form validation.

183
Jun 30, 2026