Skip to content

Commit

Permalink
Improve docs for [PageStorage] (flutter#63634)
Browse files Browse the repository at this point in the history
  • Loading branch information
xu-baolin authored and smadey committed Aug 27, 2020
1 parent c9fd3f8 commit 462824b
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions packages/flutter/lib/src/widgets/page_storage.dart
Expand Up @@ -130,8 +130,13 @@ class PageStorageBucket {
/// Usually you don't need to explicitly use a [PageStorage], since it's already
/// included in routes.
///
/// [PageStorageKey] is used by [Scrollable] if
/// `keepScrollOffset` is enabled to save their [ScrollPosition]s.
/// [PageStorageKey] is used by [Scrollable] if [ScrollController.keepScrollOffset]
/// is enabled to save their [ScrollPosition]s. When more than one
/// scrollable ([ListView], [SingleChildScrollView], [TextField], etc.) appears
/// within the widget's closest ancestor [PageStorage] (such as within the same route),
/// if you want to save all of their positions independently,
/// you should give each of them unique [PageStorageKey]s, or set some of their
/// `keepScrollOffset` false to prevent saving.
///
/// {@tool dartpad --template=freeform}
///
Expand Down

0 comments on commit 462824b

Please sign in to comment.