Buscar pacotes, repositórios e categorias de apps

Capa de stepper_list_view
Detalhes do pacotev1.0.1

stepper_list_view

StepperListView é um widget que constrói a interface de lista com o widget Stepper.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
832
Curtidas
76
Pontos Pub
135

Instalar pacote

flutter pub add stepper_list_view

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

StepperListView é um widget do Flutter projetado para criar interfaces de lista usando componentes de passos, permitindo que os usuários naveguem por etapas sequenciais de forma estruturada e visualmente intuitiva. Ele melhora fluxos de formulários ou processos ao organizar o conteúdo em seções passo a passo, ideal para onboarding, formulários de múltiplas etapas ou fluxos guiados. O widget suporta todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, garantindo consistência entre plataformas. Construído com a flexibilidade do Flutter, integra-se perfeitamente em interfaces existentes, mantendo princípios de design limpo e responsivo.

Casos de uso

  • Fluxos de onboarding
  • Formulários de múltiplos passos
  • Processos de usuário guiados
  • interfaces de rastreamento de progresso
  • Sequências de checkout
  • Percursos de tutorial

Principais recursos

  • Navegação passo a passo
  • Aparência personalizável do passo a passo
  • Compatibilidade multiplataforma
  • Suporte a layout responsivo
  • Integração fácil com aplicativos Flutter existentes
  • Suporte para layouts verticais e horizontais

Indicado para

  • Desenvolvedores criando fluxos de trabalho guiados
  • Designers que precisam de indicadores visuais de progresso
  • Aplicativos que exigem coleta de entrada em múltiplas etapas
  • Projetos direcionados para múltiplas plataformas
  • Equipes usando Flutter para desenvolvimento full-stack

Considerações

  • Pode exigir estilos personalizados para designs complexos
  • Recursos limitados de validação embutida
  • Mais adequado para sequências lineares de etapas
  • O desempenho pode variar com grandes contagens de passos
  • Não ideal para processos não lineares ou ramificados

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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.

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.