Clarify RichText selection docs#186844
Merged
auto-submit[bot] merged 1 commit intoJun 12, 2026
Merged
Conversation
Contributor
There was a problem hiding this comment.
Code Review
This pull request updates the documentation for RichText and SelectableRegion to clarify that SelectionContainer.maybeOf requires a BuildContext located below the selection provider in the widget tree, including an updated code example using a Builder. Feedback was provided to ensure consistent terminology and proper class linking for SelectionArea to align with standard Flutter documentation patterns.
38a7b3f to
7965c95
Compare
7965c95 to
e7e8f94
Compare
This was referenced Jun 12, 2026
auto-submit Bot
pushed a commit
to flutter/packages
that referenced
this pull request
Jun 12, 2026
flutter/flutter@8bdce07...b7cb925 2026-06-12 engine-flutter-autoroll@skia.org Roll Skia from cadbde1ec4b7 to 8c89bf2b0ee3 (5 revisions) (flutter/flutter#187926) 2026-06-12 engine-flutter-autoroll@skia.org Roll Packages from 1b56cde to b78ad83 (5 revisions) (flutter/flutter#187928) 2026-06-12 engine-flutter-autoroll@skia.org Roll Dart SDK from f3441f2067ae to f6c31f4c3a63 (17 revisions) (flutter/flutter#187924) 2026-06-12 engine-flutter-autoroll@skia.org Roll Fuchsia Linux SDK from 2KosSR4ONUjIB7tP_... to A3eaUn9mQ_EkSNxVI... (flutter/flutter#187923) 2026-06-12 engine-flutter-autoroll@skia.org Roll Skia from a2228b926c68 to cadbde1ec4b7 (9 revisions) (flutter/flutter#187921) 2026-06-12 kustermann@google.com Remove dynamic module loading code in flutter web engine (flutter/flutter#187777) 2026-06-12 matt.kosarek@canonical.com Remove EnableTransparentWindowBackground because it did nothing important and because Windows 10 does not support DWMWA_SYSTEMBACKDROP_TYPE (flutter/flutter#187848) 2026-06-12 engine-flutter-autoroll@skia.org Roll Fuchsia Test Scripts from dQ4PjIJB5kZFU8Y32... to EmfiOMUge_nnNS33B... (flutter/flutter#187912) 2026-06-12 mvincentong@gmail.com Clarify RichText selection docs (flutter/flutter#186844) 2026-06-12 1063596+reidbaker@users.noreply.github.com Custom KGP task and migration to AGP api for geting kgp version (flutter/flutter#182788) 2026-06-12 engine-flutter-autoroll@skia.org Roll Skia from f61acb31edf8 to a2228b926c68 (5 revisions) (flutter/flutter#187896) 2026-06-12 bdero@google.com [Flutter GPU] Expose ASTC HDR texture formats (flutter/flutter#187715) 2026-06-12 awolff@google.com Expand coverage of android_hardware_smoke_test. Add image, text, blend mode, and blur tests. (flutter/flutter#187600) 2026-06-11 bdero@google.com [Flutter GPU] Add blit operations (flutter/flutter#187289) 2026-06-11 bkonyi@google.com [flutter_tools] Fix version cache git fallback performance regression (flutter/flutter#187400) 2026-06-11 nshahan@google.com Rewrite `-d web-server` hot reload/restart tests (flutter/flutter#187453) 2026-06-11 bdero@google.com [Impeller] Allow sampling textures with manually-uploaded mip levels (flutter/flutter#187729) 2026-06-11 154381524+flutteractionsbot@users.noreply.github.com Sync CHANGELOG.md from stable (flutter/flutter#187884) 2026-06-11 47866232+chunhtai@users.noreply.github.com iOS a11y sets header trait based on heading level (flutter/flutter#186916) 2026-06-11 engine-flutter-autoroll@skia.org Roll Skia from 9f02102df298 to f61acb31edf8 (19 revisions) (flutter/flutter#187869) 2026-06-11 engine-flutter-autoroll@skia.org Roll ICU from ee5f27adc28b to d578f2e8b7bd (8 revisions) (flutter/flutter#187829) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC louisehsu@google.com,stuartmorgan@google.com on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
via-guy
pushed a commit
to via-guy/flutter
that referenced
this pull request
Jun 26, 2026
Fixes flutter#174930. This updates the RichText selection docs to call out that the context passed to `SelectionContainer.maybeOf` must be below the `SelectionArea` or `SelectableRegion` that provides the selection registrar. The sample now wraps the `RichText` in a `Builder` inside the `SelectionArea`, matching the working pattern from the issue discussion. It also adjusts the `SelectableRegion` overview so it says the region enables selection for widgets that participate in selection, rather than implying every child widget becomes selectable automatically. ## Tests - `./bin/dart format --output=none --set-exit-if-changed packages/flutter/lib/src/widgets/basic.dart packages/flutter/lib/src/widgets/selectable_region.dart` - `./bin/flutter analyze packages/flutter/lib/src/widgets/basic.dart packages/flutter/lib/src/widgets/selectable_region.dart` - `./bin/dart --enable-asserts dev/bots/analyze_snippet_code.dart packages/flutter/lib/src/widgets` - `git diff --check`
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #174930.
This updates the RichText selection docs to call out that the context passed to
SelectionContainer.maybeOfmust be below theSelectionAreaorSelectableRegionthat provides the selection registrar. The sample now wraps theRichTextin aBuilderinside theSelectionArea, matching the working pattern from the issue discussion.It also adjusts the
SelectableRegionoverview so it says the region enables selection for widgets that participate in selection, rather than implying every child widget becomes selectable automatically.Tests
./bin/dart format --output=none --set-exit-if-changed packages/flutter/lib/src/widgets/basic.dart packages/flutter/lib/src/widgets/selectable_region.dart./bin/flutter analyze packages/flutter/lib/src/widgets/basic.dart packages/flutter/lib/src/widgets/selectable_region.dart./bin/dart --enable-asserts dev/bots/analyze_snippet_code.dart packages/flutter/lib/src/widgetsgit diff --check