flutter_progress_button

Visão geral do pacote

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

flutter_progress_button é um botão personalizável de design Material de código aberto para Flutter que suporta vários estilos e estados de progresso. Criado com simplicidade e flexibilidade em mente, permite aos desenvolvedores integrar facilmente indicadores de carregamento, estados de sucesso e animações personalizadas em botões. O pacote é licenciado sob MIT e projetado para integração perfeita em qualquer projeto Flutter. Ele melhora a experiência do usuário ao fornecer feedback visual durante ações como envio de formulários ou busca de dados.

Casos de uso

Envio de formulário com estado de carregamento
Fluxos de autenticação de usuário
Operações de salvamento de dados
Elementos de interface interativa com feedback
Transições de botão personalizáveis

Principais recursos

Suporta estados de carregamento e sucesso
Aparência altamente personalizável
Integração fácil com o Flutter
Compatível com o Material Design
Transições animadas entre estados

Indicado para

Desenvolvedores construindo formulários interativos
Equipes que precisam de estilos de botão consistentes
Projetos que exigem feedback visual sobre ações
aplicações com foco em UI
Contribuidores de código aberto procurando componentes leves

Considerações

Personalização limitada por plataforma
Sem suporte interno para temas não-Material
Requer manipulação manual da lógica assíncrona
Não otimizado para máquinas de estado complexas
Depende do pacote Material do Flutter

README original

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

flutter_progress_button is a free and open source (MIT license) Material Flutter Button that supports variety of buttons style demands. It is designed to be easy to use and customizable.

Get started

Depend on it

Add this to your package's pubspec.yaml file:

flutter_progress_button: '^1.0.0'

Install it

You can install packages from the command line:

$ flutter pub get

Alternatively, your editor might support flutter pub get.

Import it

Now in your Dart code, you can use:

import 'package:flutter_progress_button/flutter_progress_button.dart';

How to use

Add ProgressButton to your widget tree:

ProgressButton(
    defaultWidget: const Text('I am a button'),
    progressWidget: const CircularProgressIndicator(),
    width: 196,
    height: 40,
    onPressed: () async {
        int score = await Future.delayed(
            const Duration(milliseconds: 3000), () => 42);
        // After [onPressed], it will trigger animation running backwards, from end to beginning
        return () {
        // Optional returns is returning a VoidCallback that will be called
        // after the animation is stopped at the beginning.
        // A best practice would be to do time-consuming task in [onPressed],
        // and do page navigation in the returned VoidCallback.
        // So that user won't missed out the reverse animation.
        };
    },
),

More parameters:

ProgressButton({
    Key key,
    this.defaultWidget,
    this.progressWidget,
    this.onPressed,
    this.type = ProgressButtonType.Raised,
    this.color,
    this.width = double.infinity,
    this.height = 40.0,
    this.borderRadius = 2.0,
    this.animate = true,
}) : super(key: key);

Three types supported:

enum ProgressButtonType {
    Raised,
    Flat,
    Outline,
}

Source

Source code and example of this library can be found in git:

$ git clone https://github.com/jiangyang5157/flutter_progress_button.git

Buscar pacotes, repositórios e categorias de apps