future_button
Customizable Material and Cupertino buttons with progress indicators and more.
Useful if you want to run some background tasks when user presses on the button, and then show the result of the task.
How to use it
Usage is extremely simple - right now 5 types of buttons are supported:
CupertinoButton(normal + filled)FlatButton(normal + icon)IconButtonOutlineButton(normal + icon)RaisedButton(normal + icon)
To convert a button to a FutureButton, just add a Future prefix and make sure that your onPressed callback is of type Future
, instead of usual void Function().
Everything that the package does can be customized. Below is the list of all parameters:
/// The widget that's used as the progress indicator.
/// You can substitute it with your own progress indicator if necessary.
/// See [defaultMaterialProgressIndicatorBuilder] and[defaultCupertinoProgressIndicatorBuilder] for more info.
final WidgetBuilder progressIndicatorBuilder;
/// The location of progress indicator.
/// See [ProgressIndicatorLocation] for more info.
final ProgressIndicatorLocation progressIndicatorLocation;
/// Whether to show the result of the Future.
/// Will show [successIndicatorBuilder] if Future completes without errors.
/// Otherwise, will show [failureIndicatorBuilder].
final bool showResult;
/// Whether to animate the transitions using [AnimatedSwitcher].
/// Defaults to [true].
final bool animateTransitions;
/// Indicator to show when the Future is completed successfully.
/// Defaults to [defaultSuccessResultIndicatorBuilder].
final WidgetBuilder successIndicatorBuilder;
/// Indicator to show when the Future fails.
/// Defaults to [defaultFailureResultIndicatorBuilder].
final WidgetBuilder failureIndicatorBuilder;
/// For how long should the result be shown for.
/// Default to `Duration(seconds: 2)`.
final Duration resultIndicatorDuration;
/// Curve that's used to animate the button size.
/// Defaults to [Curves.easeInOut].
final Curve animationCurve;
/// Duration that's used to animate the button size.
/// Defaults to `Duration(milliseconds: 150)`.
final Duration animationDuration;
Example
FutureRaisedButton.icon(
icon: Icon(Icons.star),
label: Text('Star'),
onPressed: () async {
// Do some background task
await Future.delayed(Duration(seconds: 5));
},
);
See example project for more details.
Getting Started
Depend on it
Add this to your package's pubspec.yaml file:
dependencies:
future_button: ^0.1.1
Install it
You can install packages from the command line:
$ flutter pub get
Import it
Now in your Dart code, you can use:
import 'package:future_button/future_button.dart';
Contact me
E-mail: [email protected]
6 Dec 10, 2022
162 Dec 26, 2022
3 Jan 28, 2022
131 Nov 11, 2022
196 Dec 2, 2022
0 Nov 24, 2022
144 Sep 23, 2022
213 Dec 11, 2022
2 Jul 4, 2022
8 Oct 17, 2022