maybePop<T extends Object?> method

Future<bool> maybePop<T extends Object?>([
  1. T? result
])
inherited

Consults the current route's Route.popDisposition method, and acts accordingly, potentially popping the route as a result; returns whether the pop request should be considered handled.

If the RoutePopDisposition is RoutePopDisposition.pop, then the pop method is called, and this method returns true, indicating that it handled the pop request.

If the RoutePopDisposition is RoutePopDisposition.doNotPop, then this method returns true, but does not do anything beyond that.

If the RoutePopDisposition is RoutePopDisposition.bubble, then this method returns false, and the caller is responsible for sending the request to the containing scope (e.g. by closing the application).

This method is typically called for a user-initiated pop. For example on Android it's called by the binding for the system's back button.

The T type argument is the type of the return value of the current route. (Typically this isn't known; consider specifying dynamic or Null.)

See also:

  • Form, which provides a Form.canPop boolean that enables the form to prevent any pops initiated by the app's back button.
  • ModalRoute, which provides a scopedOnPopCallback that can be used to define the route's willPop method.

Implementation

Future<bool> maybePop<T extends Object?>([T? result]) async =>
    _nav!.maybePop<T>(result);