diff --git a/packages/flutter/lib/src/widgets/navigator.dart b/packages/flutter/lib/src/widgets/navigator.dart index e094c14861..b7b8a68df6 100644 --- a/packages/flutter/lib/src/widgets/navigator.dart +++ b/packages/flutter/lib/src/widgets/navigator.dart @@ -234,9 +234,13 @@ typedef bool RoutePredicate(Route route); /// Many apps have a navigator near the top of their widget hierarchy in order /// to display their logical history using an [Overlay] with the most recently /// visited pages visually on top of the older pages. Using this pattern lets -/// the navigator visually transition from one page to another by the widgets +/// the navigator visually transition from one page to another by moving the widgets /// around in the overlay. Similarly, the navigator can be used to show a dialog /// by positioning the dialog widget above the current page. +/// +/// Although you can create a navigator directly, it's most common to use the +/// navigator created by a [WidgetsApp] or a [MaterialApp] widget. You can refer to +/// that navigator with [Navigator.of]. class Navigator extends StatefulWidget { /// Creates a widget that maintains a stack-based history of child widgets. ///