Sitelet https://github.com/flutter/packages/pull/12806
Skip to content

[material_ui] Port flutter/flutter #185475 "Accessibility: Add semanticLabel to MenuAnchor" - #12806

Merged
auto-submit[bot] merged 5 commits into
flutter:mainfrom
mbcorona:port-185475
Sep 11, 2026
Merged

auto-submit[bot] merged 5 commits into
flutter:mainfrom
mbcorona:port-185475

Conversation

@mbcorona

@mbcorona mbcorona commented Sep 9, 2026

Copy link
Copy Markdown
Member

Ports flutter/flutter#185475 to material_ui, following the instructions in flutter/flutter#188444. The commits were cherry-picked from the original PR, with only file paths adjusted for this repo.

MenuAnchor had no way to label the expanded menu overlay, so screen readers announced nothing useful when a menu opened. This adds a semanticLabel property, applied to a Semantics node wrapping the submenu in _buildOverlay, and only when a label is provided.

The original PR also announced the label with SemanticsService.announce when the menu opened. Following @chunhtai's review feedback on flutter/flutter#185475, that part is dropped here: a semantics label should not double as announcement text, and anyone who wants an announcement can call SemanticsService.announce from onOpen. The last commit on this branch removes it.

Tests

New test MenuAnchor applies semanticLabel to the expanded menu overlay in packages/material_ui/test/menu_anchor_test.dart, checking that the label is absent before the menu opens and present once it expands. The menu_anchor.0 API example now sets a semanticLabel, and its example test still passes.

Fixes flutter/flutter#184876

Supersedes flutter/flutter#185475, which will be closed with a pointer to this PR.

Pre-Review Checklist

If you need help, consider asking for advice on the #hackers-new channel on Discord.

Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

Footnotes

  1. Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. ↩ ↩2

@flutter-dashboard flutter-dashboard Bot added the CICD Run CI/CD label Sep 9, 2026
@github-actions github-actions Bot added p: material_ui triage-design Should be looked at in design triage labels Sep 9, 2026
@mbcorona
mbcorona requested a review from chunhtai September 9, 2026 12:17

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a semanticLabel property to the MenuAnchor widget, wrapping the expanded menu overlay in a Semantics widget when a label is provided. A corresponding test case and example update are also included. The review feedback recommends setting explicitChildNodes: true on the Semantics widget to ensure child menu items are treated as separate interactive nodes in the semantics tree.

Comment thread packages/material_ui/lib/src/menu_anchor.dart
@mbcorona mbcorona added the autosubmit Merge PR when tree becomes green via auto submit App label Sep 11, 2026
@auto-submit
auto-submit Bot merged commit 87910ce into flutter:main Sep 11, 2026
13 checks passed
dkwingsmt pushed a commit to dkwingsmt/flutter that referenced this pull request Sep 15, 2026
…r#192809)

flutter/packages@9caa77c...bebbb57

2026-09-15 5684363+tenninebt@users.noreply.github.com
[google_maps_flutter_platform_interface] Add onPointOfInterestTap
support (flutter/packages#12752)
2026-09-14 stuartmorgan@google.com [google_maps_flutter] Adopts new
async/await Swift Pigeon support (flutter/packages#12860)
2026-09-14 109692895+Massinissa-Mouhoub@users.noreply.github.com
[material_ui] Fix `todayBorder` color being overridden by
`todayForegroundColor` in `YearPicker` (flutter/packages#12697)
2026-09-13 engine-flutter-autoroll@skia.org Roll Flutter from
2553f89 to 8b3e8f5 (4 revisions) (flutter/packages#12856)
2026-09-12 stuartmorgan@google.com [google_maps_flutter] Convert
remaining code to Swift (flutter/packages#12768)
2026-09-12 engine-flutter-autoroll@skia.org Roll Flutter from
63b9518 to 2553f89 (62 revisions) (flutter/packages#12855)
2026-09-12 engine-flutter-autoroll@skia.org Roll Flutter (stable) from
d3b14c8 to 9584c67 (15 revisions) (flutter/packages#12854)
2026-09-12 36861262+QuncCccccc@users.noreply.github.com [material_ui]
Update gen_defaults color helper (flutter/packages#12846)
2026-09-11 brunocorona.alcantar@gmail.com [material_ui] Port
flutter/flutter flutter#185475 "Accessibility: Add semanticLabel to MenuAnchor"
(flutter/packages#12806)

If this roll has caused a breakage, revert this CL and set the roller
to dry run mode using the controls here:
https://autoroll.skia.org/r/flutter-packages-flutter-autoroll
Please CC flutter-ecosystem@google.com on the revert to ensure that a
human
is aware of the problem.

To file a bug in Flutter:
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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autosubmit Merge PR when tree becomes green via auto submit App CICD Run CI/CD p: material_ui triage-design Should be looked at in design triage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

No Accessibility label on expanded menu of MenuAnchor

2 participants