搜尋套件、儲存庫與 APP 分類

stepper_list_view 封面
套件詳情v1.0.1

stepper_list_view

StepperListView 是一個使用 Stepper 小部件建構列表 UI 的小部件。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
832
喜歡數
76
Pub 分數
135

安裝套件

flutter pub add stepper_list_view

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

StepperListView 是一個專為建立使用階梯組件的列表介面所設計的 Flutter 小部件,讓使用者能以結構化且直覺的視覺方式導航一系列步驟。它透過將內容組織成逐步的章節來增強表單或流程,非常適合用於引導入門、多階段表單或導向式工作流程。該小部件支援所有主要平台,包括 Android、iOS、Web、macOS、Windows 和 Linux,確保跨平台的一致性。基於 Flutter 的彈性構建,它可無縫整合至現有 UI 中,同時維持乾淨、響應式的設計原則。

適用情境

  • 引導流程
  • 多步驟表單
  • 引導式使用者流程
  • 進度追蹤介面
  • 結帳序列
  • 教學走查

主要特色

  • 逐步導航
  • 可自訂的步進器外觀
  • 跨平台相容性
  • 響應式版面支援
  • 與現有 Flutter 應用的輕鬆整合
  • 支援垂直與水平佈局

適合對象

  • 開發人員建構引導式工作流程
  • 需要視覺進度指示器的設計師
  • 需要多階段輸入收集的應用程式
  • 針對多個平台的專案
  • 使用 Flutter 進行全端開發的團隊

使用建議

  • 可能需要自定樣式以實現複雜設計
  • 有限的內建驗證功能
  • 最適合線性步驟序列
  • 效能可能隨著步數增加而有所變化
  • 不適合非線性或分支流程

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

StepperListView

A customizable Flutter widget for building beautiful stepper-based list UIs such as timelines, activity histories, event logs, and more.

![](C:/Users/Bhardwaj/Downloads/steppr_list_view.gif)


Installation

Add to your pubspec.yaml:

dependencies:
  stepper_list_view: <latest_version>

Features

  • ✔ Stepper-style list items
  • ✔ Highly customizable UI
  • ✔ Custom avatar builder
  • ✔ Custom step label builder
  • ✔ Custom content builder
  • ✔ Optional stepper line on last item
  • ✔ Supports list sorting
  • ✔ Smooth physics support
  • ✔ Custom dashed or solid line
  • ✔ Easy integration

Documentation

Component Description
StepperListView Main widget that renders the entire stepper UI
StepperItemData Data model for each list item
StepperThemeData Customization for stepper line and visuals
RootPainter Internal painter that draws the connecting line

Customize options

StepperThemeData
Property Description
lineColor Color of the line connecting steps
lineWidth Thickness of the line
dashLength Dash segment length (for dashed lines)
dashGap Gap between dashes
Builder Options
Callback Purpose
stepAvatar Builds avatar or step icon
stepWidget Builds the label beside the avatar
stepContentWidget Builds the main content area

Usage/Examples

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:stepper_list_view/stepper_list_view.dart';
import 'package:url_launcher/url_launcher.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.orange,
      ),
      home: const MyHomePage(title: 'Stepper List Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  
  final _stepperData = List.generate(10, (index) => StepperItemData(
    id: '$index',
    content: ({
      'name': 'Subhash Chandra Shukla',
      'occupation': 'Flutter Development',
      'mobileNumber': '7318459902',
      'email': 'subhashchandras7318@gmail.com',
      'born_date': '12\nAug',
      "contact_list": {
        "LinkedIn": "https://www.linkedin.com/in/subhashcs/",
        "Portfolio": "https://subhashdev121.github.io/subhash/#/",
      }
    }),
    avatar: 'https://avatars.githubusercontent.com/u/70679949?v=4',
  )).toList();

  @override
  Widget build(BuildContext context) {
    final theme = Theme.of(context);
    return Scaffold(
      appBar: AppBar(
        title: Text(
          widget.title,
          style: const TextStyle(
            color: Colors.white,
          ),
        ),
      ),
      body: Padding(
        padding: const EdgeInsets.all(20.0),
        child: StepperListView(
          showStepperInLast: true,
          stepperData: _stepperData,
          stepAvatar: (_, data) {
            final stepData = data as StepperItemData;
            return PreferredSize(
              preferredSize: const Size.fromRadius(20),
              child: CircleAvatar(
                backgroundImage: NetworkImage(
                  stepData.avatar!,
                ),
              ),
            );
          },
          stepWidget: (_, data) {
            final stepData = data as StepperItemData;
            return PreferredSize(
              preferredSize: const Size.fromWidth(30),
              child: Text(
                stepData.content['born_date'] ?? '',
                style: TextStyle(
                  color: theme.primaryColor,
                  fontSize: 13,
                ),
                textAlign: TextAlign.center,
              ),
            );
          },
          stepContentWidget: (_, data) {
            final stepData = data as StepperItemData;
            return Container(
              margin: const EdgeInsets.only(
                top: 20,
              ),
              padding: const EdgeInsets.all(
                15,
              ),
              child: ListTile(
                contentPadding: const EdgeInsets.all(7),
                visualDensity: const VisualDensity(
                  vertical: -4,
                  horizontal: -4,
                ),
                title: Text(stepData.content['name'] ?? ''),
                subtitle: Column(
                  mainAxisSize: MainAxisSize.min,
                  crossAxisAlignment: CrossAxisAlignment.start,
                  children: [
                    const SizedBox(
                      height: 10,
                    ),
                    Row(
                      children: [
                        const Expanded(
                          flex: 3,
                          child: Icon(Icons.work),
                        ),
                        Expanded(
                          flex: 7,
                          child: Text(stepData.content['occupation'] ?? ''),
                        ),
                      ],
                    ),
                    const SizedBox(
                      height: 10,
                    ),
                    Row(
                      children: [
                        const Expanded(
                          flex: 3,
                          child: Icon(Icons.phone),
                        ),
                        Expanded(
                          flex: 7,
                          child: Text(stepData.content['mobileNumber'] ?? ''),
                        ),
                      ],
                    ),
                    const SizedBox(
                      height: 10,
                    ),
                    Row(
                      children: [
                        const Expanded(
                          flex: 3,
                          child: Icon(Icons.email),
                        ),
                        Expanded(
                          flex: 7,
                          child: Text(stepData.content['email'] ?? ''),
                        ),
                      ],
                    ),
                    const SizedBox(
                      height: 20,
                    ),
                    Text(
                      'Contact Link',
                      style: theme.textTheme.titleMedium,
                    ),
                    const SizedBox(
                      height: 7,
                    ),
                    Padding(
                      padding: const EdgeInsets.only(left: 10),
                      child: Column(
                        mainAxisSize: MainAxisSize.min,
                        crossAxisAlignment: CrossAxisAlignment.start,
                        children: [
                          Row(
                            crossAxisAlignment: CrossAxisAlignment.start,
                            children: [
                              Expanded(
                                flex: 3,
                                child: Text(
                                  'Linked-In',
                                  style: theme.textTheme.caption,
                                ),
                              ),
                              Expanded(
                                flex: 7,
                                child: GestureDetector(
                                  onTap: () {
                                    _launchURL(stepData.content['contact_list']['LinkedIn']);
                                  },
                                  child: Text(
                                    stepData.content['contact_list']['LinkedIn'] ?? '',
                                    style: theme.textTheme.titleMedium?.copyWith(
                                      color: Colors.blue,
                                      decoration: TextDecoration.underline,
                                    ),
                                  ),
                                ),
                              ),
                            ],
                          ),
                          const SizedBox(
                            height: 10,
                          ),
                          Row(
                            crossAxisAlignment: CrossAxisAlignment.start,
                            children: [
                              Expanded(
                                flex: 3,
                                child: Text(
                                  'Portfolio',
                                  style: theme.textTheme.caption,
                                ),
                              ),
                              Expanded(
                                flex: 7,
                                child: GestureDetector(
                                  onTap: () {
                                    _launchURL(stepData.content['contact_list']['Portfolio']);
                                  },
                                  child: Text(
                                    stepData.content['contact_list']['Portfolio'] ?? '',
                                    style: theme.textTheme.titleMedium?.copyWith(
                                      color: Colors.blue,
                                      decoration: TextDecoration.underline,
                                    ),
                                  ),
                                ),
                              ),
                            ],
                          ),
                        ],
                      ),
                    ),
                    const SizedBox(
                      height: 20,
                    ),
                  ],
                ),
                shape: RoundedRectangleBorder(
                  borderRadius: BorderRadius.circular(8),
                  side: BorderSide(
                    color: theme.dividerColor,
                    width: 0.8,
                  ),
                ),
              ),
            );
          },
          stepperThemeData: StepperThemeData(
            lineColor: theme.primaryColor,
            lineWidth: 5,
          ),
          physics: const BouncingScrollPhysics(),
        ),
      ),
    );
  }

  Future<void> _launchURL(String? url) async {
    if (url == null) {
      return;
    }
    try {
      if (await canLaunchUrl(Uri.parse(url))) {
        await launchUrl(Uri.parse(url));
      }
      return;
    } catch (e) {
      if (kDebugMode) {
        print('Failed to launch URL - $e');
      }
    }
  }
}


Motivation

During development of one of my apps, I needed a highly customizable stepper-style list layout that could:

Display a date or time label

Show a circle avatar or custom step widget

Display rich content beside each step

Since Flutter doesn’t provide such a widget out of the box, StepperListView was created.


Demo

steppr_list_view


🚀 About Me

I’m a Flutter Developer passionate about reusable UI components and designing elegant UI systems.

🔗 Links

portfolio linkedin medium


License

This project is licensed under the MIT License. See the LICENSE file for full details.

所屬分類

依賴

依賴清單 1 項

原始碼儲存庫

使用此套件的專案

暫無相關資料。