A route that can handle back navigations internally by popping a list.

When a Navigator is instructed to pop, the current route is given an opportunity to handle the pop internally. A LocalHistoryRoute handles the pop internally if its list of local history entries is non-empty. Rather than being removed as the current route, the most recent LocalHistoryEntry is removed from the list and its onRemove is called.

Inheritance

Constructors

LocalHistoryRoute()

Properties

willHandlePopInternally bool

read-only
currentResult → T

When this route is popped (see Navigator.pop) if the result isn't specified or if it's null, this value will be used instead.

read-only, inherited
focusKey GlobalKey

The key this route will use for its root Focus widget, if any.

read-only, inherited
hashCode int

Get a hash code for this object.

read-only, inherited
isActive bool

Whether this route is on the navigator.

read-only, inherited
isCurrent bool

Whether this route is the top-most route on the navigator.

read-only, inherited

The navigator that the route is in, if any.

read-only, inherited
overlayEntries List<OverlayEntry>

The overlay entries for this route.

read-only, inherited
popped Future<T>

A future that completes when this route is popped off the navigator.

read-only, inherited
runtimeType Type

A representation of the runtime type of the object.

read-only, inherited

Operators

operator ==(other) bool

The equality operator.

inherited

Methods

addLocalHistoryEntry(LocalHistoryEntry entry) → void

Adds a local history entry to this route.

didPop(T result) bool

A request was made to pop this route. If the route can handle it internally (e.g. because it has its own stack of internal state) then return false, otherwise return true. Returning false will prevent the default behavior of NavigatorState.pop().

removeLocalHistoryEntry(LocalHistoryEntry entry) → void

Remove a local history entry from this route.

didChangeNext(Route nextRoute) → void

This route's next route has changed to the given new route. This is called on a route whenever the next route changes for any reason, except for cases when didPopNext() would be called, so long as it is in the history. nextRoute will be null if there's no next route.

inherited
didPopNext(Route nextRoute) → void

The given route, which came after this one, has been popped off the navigator.

inherited
didPush() → void

Called after install() when the route is pushed onto the navigator.

inherited
didReplace(Route oldRoute) → void

Called after install() when the route replaced another in the navigator.

inherited
dispose() → void

The route should remove its overlays and free any other resources.

inherited
install(OverlayEntry insertionPoint) → void

Called when the route is inserted into the navigator.

inherited
noSuchMethod(Invocation invocation) → dynamic

Invoked when a non-existent method or property is accessed.

inherited
startPopGesture(NavigatorState navigator) NavigationGestureController

If the route's transition can be popped via a user gesture (e.g. the iOS back gesture), this should return a controller object that can be used to control the transition animation's progress. Otherwise, it should return null.

inherited
toString() String

Returns a string representation of this object.

inherited