FutureBuilder<T> class
A f.FutureBuilder that displays a progress indicator while its connection state is not done.
The widget provided by onDone will only be displayed when the connection state is not ConnectionState.waiting.
The progress indicator can be changed using the indicator parameter (defaults to a centered CircularProgressIndicator).
The following usage
// fluttils:
FutureBuilder<int>(
someFuture,
onDone: (_, data) => Text("value: $data"),
);
is equivalent to
// flutter:
FutureBuilder<int>(
future: someFuture,
builder: (_, snapshot) {
if (snapshot.connectionState == ConnectionState.waiting)
return Center(child: CircularProgressIndicator());
final int data = snapshot.data!;
return Text("value: $data");
},
);
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatelessWidget
- FutureBuilder
Constructors
-
FutureBuilder(Future<
T> future, {required Widget onDone(BuildContext, T), T? initialData, Widget onError(BuildContext, Object, StackTrace) = _onErrorDefault, Widget indicator = const f.Center(child: f.CircularProgressIndicator())}) -
Creates a FutureBuilder with some commonly used f.FutureBuilder
parameters.
const
Properties
-
future
→ Future<
T> -
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- indicator → Widget
-
final
- initialData → T?
-
final
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- onDone → Widget Function(BuildContext, T)
-
final
- onError → Widget Function(BuildContext, Object, StackTrace)
-
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
build(
BuildContext context) → Widget -
Describes the part of the user interface represented by this widget.
override
-
createElement(
) → StatelessElement -
Creates a StatelessElement to manage this widget's location in the tree.
inherited
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of
DiagnosticsNode
objects describing this node's children.inherited -
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited