Flutter 页面之间传参— —pushNamed

pushNamed<T extends Object> method

1. @optionalTypeArgs

Future<T> pushNamed <T extends Object>(BuildContext context,String routeName, {Object arguments})

@optionalTypeArgs

Push a named route onto the navigator that most tightly encloses the given context.

The route name will be passed to that navigator's onGenerateRoute callback. The returned route will be pushed into the navigator.

The new route and the previous route (if any) are notified (see Route.didPush and Route.didChangeNext). If the Navigator has any Navigator.observers, they will be notified as well (see NavigatorObserver.didPush).

Ongoing gestures within the current route are canceled when a new route is pushed.

Returns a Future that completes to the result value passed to pop when the pushed route is popped off the navigator.

The T type argument is the type of the return value of the route. The provided arguments are passed to the pushed route via RouteSettings.arguments. Any object can be passed as arguments (e.g. a String, int, or an instance of a custom MyRouteArguments class). Often, a Map is used to pass key-value pairs.

The arguments may be used in Navigator.onGenerateRoute or Navigator.onUnknownRoute to construct the route.

 

Sample

Typical usage is as follows:

assignment

void _didPushButton() {
  Navigator.pushNamed(context, '/settings');
}

 

Sample

The following example shows how to pass additional arguments to the route:

assignment

void _showBerlinWeather() {
  Navigator.pushNamed(
    context,
    '/weather',
    arguments: <String, String>{
      'city': 'Berlin',
      'country': 'Germany',
    },
  );
}

 

Sample

The following example shows how to pass a custom Object to the route:

assignment

class WeatherRouteArguments {
  WeatherRouteArguments({ this.city, this.country });
  final String city;
  final String country;

  bool get isGermanCapital {
    return country == 'Germany' && city == 'Berlin';
  }
}

void _showWeather() {
  Navigator.pushNamed(
    context,
    '/weather',
    arguments: WeatherRouteArguments(city: 'Berlin', country: 'Germany'),
  );
}

 

Implementation

@optionalTypeArgs
static Future<T> pushNamed<T extends Object>(
  BuildContext context,
  String routeName, {
  Object arguments,
 }) {
  return Navigator.of(context).pushNamed<T>(routeName, arguments: arguments);
}