showCupertinoModalPopup<T> function

Future<T> showCupertinoModalPopup <T>({@required BuildContext context, @required Widget builder })

Shows a modal iOS-style popup that slides up from the bottom of the screen.

Such a popup is an alternative to a menu or a dialog and prevents the user from interacting with the rest of the app.

The context argument is used to look up the Navigator for the popup. It is only used when the method is called. Its corresponding widget can be safely removed from the tree before the popup is closed.

The builder argument typically builds a CupertinoActionSheet widget. Content below the widget is dimmed with a ModalBarrier. The widget built by the builder does not share a context with the location that showCupertinoModalPopup is originally called from. Use a StatefulBuilder or a custom StatefulWidget if the widget needs to update dynamically.

Returns a Future that resolves to the value that was passed to Navigator.pop when the popup was closed.

See also:

Implementation

Future<T> showCupertinoModalPopup<T>({
  @required BuildContext context,
  @required WidgetBuilder builder,
}) {
  return Navigator.of(context, rootNavigator: true).push(
    _CupertinoModalPopupRoute<T>(
      builder: builder,
      barrierLabel: 'Dismiss',
    ),
  );
}