NavigatorState class Null safety

The state for a Navigator widget.

A reference to this class can be obtained by calling Navigator.of.

Inheritance
Mixed in types

Constructors

Properties

bucket → RestorationBucket?
The RestorationBucket used for the restoration data of the RestorablePropertys registered to this mixin.
read-onlyinherited
context → BuildContext
The location in the tree where this widget builds.
read-onlyinherited
focusScopeNode → FocusScopeNode
The FocusScopeNode for the FocusScope that encloses the routes.
final
hashCode → int
The hash code for this object.
read-onlyinherited
mounted → bool
Whether this State object is currently in a tree.
read-onlyinherited
overlay → OverlayState?
The overlay this navigator uses for its visual presentation.
read-only
restorationId → String?
The restoration ID used for the RestorationBucket in which the mixin will store the restoration data of all registered properties.
read-onlyoverride
restorePending → bool
Whether restoreState will be called at the beginning of the next build phase.
read-onlyinherited
runtimeType → Type
A representation of the runtime type of the object.
read-onlyinherited
userGestureInProgress → bool
Whether a route is currently being manipulated by the user, e.g. as during an iOS back gesture.
read-only
userGestureInProgressNotifier → ValueNotifier<bool>
Notifies its listeners if the value of userGestureInProgress changes.
final
widget → Navigator
The current configuration.
read-onlyinherited

Methods

activate() → void
Called when this object is reinserted into the tree after having been removed via deactivate.
override
build(BuildContext context) → Widget
Describes the part of the user interface represented by this widget.
override
canPop() → bool
Whether the navigator can be popped.
createTicker(TickerCallback onTick) → Ticker
Creates a ticker with the given callback.
inherited
deactivate() → void
Called when this object is removed from the tree.
override
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
didChangeDependencies() → void
Called when a dependency of this State object changes.
override
didStartUserGesture() → void
The navigator is being controlled by a user gesture.
didStopUserGesture() → void
A user gesture completed.
didToggleBucket(RestorationBucket? oldBucket) → void
Called when bucket switches between null and non-null values.
override
didUpdateRestorationId() → void
Must be called when the value returned by restorationId changes.
protected">@protectedinherited
didUpdateWidget(covariant Navigator oldWidget) → void
Called whenever the widget configuration changes.
override
dispose() → void
Called when this object is removed from the tree permanently.
override
finalizeRoute(Route route) → void
Complete the lifecycle for a route that has been popped off the navigator.
initState() → void
Called when this object is inserted into the tree.
override
maybePop<T extends Object?>([T? result]) → Future<bool>
Consults the current route's Route.willPop method, and acts accordingly, potentially popping the route as a result; returns whether the pop request should be considered handled.
optionalTypeArgs">@optionalTypeArgs
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed.
inherited
pop<T extends Object?>([T? result]) → void
Pop the top-most route off the navigator.
optionalTypeArgs">@optionalTypeArgs
popAndPushNamed<T extends Object?, TO extends Object?>(String routeName, {TO? result, Object? arguments}) → Future<T?>
Pop the current route off the navigator and push a named route in its place.
optionalTypeArgs">@optionalTypeArgs
popUntil(RoutePredicate predicate) → void
Calls pop repeatedly until the predicate returns true.
push<T extends Object?>(Route<T> route) → Future<T?>
Push the given route onto the navigator.
optionalTypeArgs">@optionalTypeArgs
pushAndRemoveUntil<T extends Object?>(Route<T> newRoute, RoutePredicate predicate) → Future<T?>
Push the given route onto the navigator, and then remove all the previous routes until the predicate returns true.
optionalTypeArgs">@optionalTypeArgs
pushNamed<T extends Object?>(String routeName, {Object? arguments}) → Future<T?>
Push a named route onto the navigator.
optionalTypeArgs">@optionalTypeArgs
pushNamedAndRemoveUntil<T extends Object?>(String newRouteName, RoutePredicate predicate, {Object? arguments}) → Future<T?>
Push the route with the given name onto the navigator, and then remove all the previous routes until the predicate returns true.
optionalTypeArgs">@optionalTypeArgs
pushReplacement<T extends Object?, TO extends Object?>(Route<T> newRoute, {TO? result}) → Future<T?>
Replace the current route of the navigator by pushing the given route and then disposing the previous route once the new route has finished animating in.
optionalTypeArgs">@optionalTypeArgs
pushReplacementNamed<T extends Object?, TO extends Object?>(String routeName, {TO? result, Object? arguments}) → Future<T?>
Replace the current route of the navigator by pushing the route named routeName and then disposing the previous route once the new route has finished animating in.
optionalTypeArgs">@optionalTypeArgs
reassemble() → void
Called whenever the application is reassembled during debugging, for example during hot reload.
mustCallSuper">@mustCallSuperprotected">@protectedinherited
registerForRestoration(RestorableProperty<Object?> property, String restorationId) → void
Registers a RestorableProperty for state restoration.
protected">@protectedinherited
removeRoute(Route route) → void
Immediately remove route from the navigator, and Route.dispose it.
removeRouteBelow(Route anchorRoute) → void
Immediately remove a route from the navigator, and Route.dispose it. The route to be removed is the one below the given anchorRoute.
replace<T extends Object?>({required Route oldRoute, required Route<T> newRoute}) → void
Replaces a route on the navigator with a new route.
optionalTypeArgs">@optionalTypeArgs
replaceRouteBelow<T extends Object?>({required Route anchorRoute, required Route<T> newRoute}) → void
Replaces a route on the navigator with a new route. The route to be replaced is the one below the given anchorRoute.
optionalTypeArgs">@optionalTypeArgs
restorablePopAndPushNamed<T extends Object?, TO extends Object?>(String routeName, {TO? result, Object? arguments}) → String
Pop the current route off the navigator and push a named route in its place.
optionalTypeArgs">@optionalTypeArgs
restorablePush<T extends Object?>(RestorableRouteBuilder<T> routeBuilder, {Object? arguments}) → String
Push a new route onto the navigator.
optionalTypeArgs">@optionalTypeArgs
restorablePushAndRemoveUntil<T extends Object?>(RestorableRouteBuilder<T> newRouteBuilder, RoutePredicate predicate, {Object? arguments}) → String
Push a new route onto the navigator, and then remove all the previous routes until the predicate returns true.
optionalTypeArgs">@optionalTypeArgs
restorablePushNamed<T extends Object?>(String routeName, {Object? arguments}) → String
Push a named route onto the navigator.
optionalTypeArgs">@optionalTypeArgs
restorablePushNamedAndRemoveUntil<T extends Object?>(String newRouteName, RoutePredicate predicate, {Object? arguments}) → String
Push the route with the given name onto the navigator, and then remove all the previous routes until the predicate returns true.
optionalTypeArgs">@optionalTypeArgs
restorablePushReplacement<T extends Object?, TO extends Object?>(RestorableRouteBuilder<T> routeBuilder, {TO? result, Object? arguments}) → String
Replace the current route of the navigator by pushing a new route and then disposing the previous route once the new route has finished animating in.
optionalTypeArgs">@optionalTypeArgs
restorablePushReplacementNamed<T extends Object?, TO extends Object?>(String routeName, {TO? result, Object? arguments}) → String
Replace the current route of the navigator by pushing the route named routeName and then disposing the previous route once the new route has finished animating in.
optionalTypeArgs">@optionalTypeArgs
restorableReplace<T extends Object?>({required Route oldRoute, required RestorableRouteBuilder<T> newRouteBuilder, Object? arguments}) → String
Replaces a route on the navigator with a new route.
optionalTypeArgs">@optionalTypeArgs
restorableReplaceRouteBelow<T extends Object?>({required Route anchorRoute, required RestorableRouteBuilder<T> newRouteBuilder, Object? arguments}) → String
Replaces a route on the navigator with a new route. The route to be replaced is the one below the given anchorRoute.
optionalTypeArgs">@optionalTypeArgs
restoreState(RestorationBucket? oldBucket, bool initialRestore) → void
Called to initialize or restore the RestorablePropertys used by the State object.
override
setState(VoidCallback fn) → void
Notify the framework that the internal state of this object has changed.
protected">@protectedinherited
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
toStringShort() → String
A brief description of this object, usually just the runtimeType and the hashCode.
inherited
unregisterFromRestoration(RestorableProperty<Object?> property) → void
Unregisters a RestorableProperty from state restoration.
protected">@protectedinherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited