BackButtonDispatcher class Null safety
Report to a Router when the user taps the back button on platforms that support back buttons (such as Android).
When Router widgets are nested, consider using a ChildBackButtonDispatcher, passing it the parent BackButtonDispatcher, so that the back button requests get dispatched to the appropriate Router. To make this work properly, it's important that whenever a Router thinks it should get the back button messages (e.g. after the user taps inside it), it calls takePriority on its BackButtonDispatcher (or ChildBackButtonDispatcher) instance.
The class takes a single callback, which must return a Future<bool>. The callback's semantics match WidgetsBindingObserver.didPopRoute's, namely, the callback should return a future that completes to true if it can handle the pop request, and a future that completes to false otherwise.
- Implementers
Constructors
Properties
- hasCallbacks → bool
-
Whether a callback is currently registered.
read-only
- hashCode → int
-
The hash code for this object.
read-onlyinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-onlyinherited
Methods
-
addCallback(
ValueGetter< Future< callback) → voidbool> > -
Register the callback to be called when the object changes.
inherited
-
createChildBackButtonDispatcher(
) → ChildBackButtonDispatcher - Creates a ChildBackButtonDispatcher that is a direct descendant of this back button dispatcher.
-
deferTo(
ChildBackButtonDispatcher child) → void - Mark the given child as taking priority over this object and the other children.
-
forget(
ChildBackButtonDispatcher child) → void - Causes the given child to be removed from the list of children to which this object might defer, as if deferTo had never been called for that child.
-
invokeCallback(
Future< bool> defaultValue) → Future<bool> - Handles a pop route request.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed.
inherited
-
removeCallback(
ValueGetter< Future< callback) → voidbool> > -
Remove a previously registered callback.
inherited
-
takePriority(
) → void - Make this BackButtonDispatcher take priority among its peers.
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited