samples/navigation_and_routing/README.md

# Navigation and Routing sample code

Sample code for [Learning Flutter's New Navigation and Routing System][article],
an article explaining Navigator 2.0.

## Samples

**Navigator 1.0 samples**

* [nav_1/anonymous_routes.dart](lib/nav_1/anonymous_routes.dart) - Shows how to use a Navigator to push and pop
  anonymous routes (e.g. MaterialPageRoute)
* [nav_1/named_routes.dart](lib/nav_1/named_routes.dart) - Shows how to use define named routes via the `routes`
  parameter on MaterialApp, and navigate using Navigator.pushNamed
* [nav_1/on_generate_route.dart](lib/nav_1/on_generate_route.dart) - Shows how to handle arbitrary named routes
  using the `onGenerateRoute` callback defined in the `MaterialApp` constructor.

**Navigator 2.0 samples**

* [nav_2/pages.dart](lib/nav_2/pages.dart) - Shows how to define a list of [Page] objects on Navigator
  declaratively.
* [nav_2/router.dart](lib/nav_2/router.dart) - Full sample that shows a custom RouteInformationParser
  and RouterDelegate parsing named routes and declaratively building the stack
  of pages for the Navigator.


**Advanced**

* [nav_2_advanced/nested_router.dart](lib/nav_2_advanced/nested_router.dart) - Shows two [RouterDelegate], one nested
  within the other. A [BottomNavigationBar] can be used to select the route of
  the outer RouterDelegate, and additional routes can be pushed onto the inner
  RouterDelegate / Navigator.
* [nav_2_advanced/transition_delegate.dart](lib/nav_2_advanced/transition_delegate.dart) - Shows how a custom
  TransitionDelegate can be used to customized when transition animations are
  shown.


## Running

Each file in this project is an entrypoint. To run, specify the filename of
the sample:

```bash
flutter run lib/nav_2/router.dart
```

[article]: https://medium.com/flutter/learning-flutters-new-navigation-and-routing-system-7c9068155ade