Search packages, repositories and app categories

progress_state_button cover
Package detailsv1.0.4

progress_state_button

A customizable progress button widget for Flutter Android, IOS and Web.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
2.4K
Likes
373
Pub points
130

Install package

flutter pub add progress_state_button

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A customizable progress button widget for Flutter that supports Android, iOS, Web, macOS, Windows, and Linux. It allows developers to create buttons with dynamic states such as loading, success, error, and idle, enhancing user feedback during actions like form submissions or API calls. The widget is highly configurable, enabling customization of colors, labels, icons, and animations. It integrates seamlessly into existing Flutter apps and provides a consistent experience across platforms.

Use cases

  • Form submission with loading state
  • Authentication flow progress
  • File upload indicators
  • Payment processing UI
  • Onboarding wizard steps

Key features

  • Multiple state support (idle, loading, success, error)
  • Customizable appearance and behavior
  • Cross-platform compatibility
  • Animated transitions between states
  • Configurable labels and icons
  • Easy integration with existing widgets

Suitable for

  • Developers building interactive forms
  • Teams prioritizing UX consistency
  • Apps requiring real-time feedback
  • Cross-platform mobile and web applications
  • Projects with complex user workflows

Considerations

  • Requires understanding of Flutter state management
  • May need additional styling for complex designs
  • Limited to button-specific use cases
  • Not suitable for non-interactive elements
  • Depends on platform-specific rendering behaviors

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Progress State Button

A customizable progress button for Flutter

Test with DartPad

Installation

https://pub.dev/packages/progress_state_button

progress_state_button: "^1.0.4"

Usage

Icon

ProgressButton.icon(iconedButtons: {
      ButtonState.idle:
        IconedButton(
            text: "Send",
            icon: Icon(Icons.send,color: Colors.white),
            color: Colors.deepPurple.shade500),
      ButtonState.loading:
        IconedButton(
            text: "Loading",
            color: Colors.deepPurple.shade700),
      ButtonState.fail:
        IconedButton(
            text: "Failed",
            icon: Icon(Icons.cancel,color: Colors.white),
            color: Colors.red.shade300),
      ButtonState.success:
        IconedButton(
            text: "Success",
            icon: Icon(Icons.check_circle,color: Colors.white,),
            color: Colors.green.shade400)
    }, 
    onPressed: onPressed,
    state: ButtonState.idle);
With Custom Widgets

ProgressButton(
      stateWidgets: {
        ButtonState.idle: Text("Idle",style: TextStyle(color: Colors.white, fontWeight: FontWeight.w500),),
        ButtonState.loading: Text("Loading",style: TextStyle(color: Colors.white, fontWeight: FontWeight.w500),),
        ButtonState.fail: Text("Fail",style: TextStyle(color: Colors.white, fontWeight: FontWeight.w500),),
        ButtonState.success: Text("Success",style: TextStyle(color: Colors.white, fontWeight: FontWeight.w500),)
      },
      stateColors: {
        ButtonState.idle: Colors.grey.shade400,
        ButtonState.loading: Colors.blue.shade300,
        ButtonState.fail: Colors.red.shade300,
        ButtonState.success: Colors.green.shade400,
      },
      onPressed: onPressed,
      state: ButtonState.idle,
    );
Constructors
Default constructor of ProgressButton
stateWidgets - Widgets of states
stateColors - Background color oof states
state = ButtonState.idle` - Current state of button
onPressed - onPressed function same like MaterialButton
onAnimationEnd - onAnimatedEnd function calls like that onAnimatedEnd(AnimationStatus animationStatus,ButtonState currentState).
minWidth = 200.0 - Loading state width
maxWidth = 400.0 - failed,success,idle states width
radius = 16.0 - Button radius
height = 53.0 - Button height
circularProgressIndicator - CircularProgressIndicator widget, default is instating with current state color.
progressIndicatorAlignment = MainAxisAlignment.spaceBetween` - ProgressIndicator aligment
progressIndicatorSize = 35.0 - size of progress indicator
padding = EdgeInsets.zero - Padding of button
minWidthStates = List of min width states, loading is the default. If you want to make small only icon states define them on this.
animationDuration = Transition animation duration.
ProgressButton.icon() specific constructors
Map<ButtonState, IconedButton> iconedButtons- State and IconedButton map
double iconPadding: 4.0 - Padding of icon 
TextStyle textStyle - TextStyle of all of states

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Categories

Source repository

Projects using this package

No data available yet.