Skip to content

[ui/accessibility] Update web accessibility docs for Flutter 3.50 - #13987

Open
kevmoo wants to merge 4 commits into
mainfrom
web-a11y-13963
Open

kevmoo wants to merge 4 commits into
mainfrom
web-a11y-13963

Conversation

@kevmoo

@kevmoo kevmoo commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Updates web accessibility and testing documentation for the Flutter 3.50 WCAG 2.1 AA improvements and removes a duplicated sentence in web-accessibility.md:

  • Documents <input type="range" role="slider"> semantics (Slider, RangeSlider, and SemanticsRole.slider), named route role="region" landmarks, focus preservation across semantic role changes, and Escape tooltip dismissal.
  • Documents maximum-scale=5.0 viewport pinch-to-zoom, iOS Safari 16px input font-size floor, <flutter-view> scoping for <flt-semantics-placeholder>, and runtime debugShowSemanticsNodes: true configuration in flutter_bootstrap.js.

Fixes #13963

- Remove the duplicated sentence on `web-accessibility.md` line 49.
- Document Flutter 3.50 WCAG 2.1 AA web accessibility improvements: `Slider`/`RangeSlider` and `SemanticsRole.slider` `<input type="range" role="slider">` semantics, named route `role="region"` landmarks, focus preservation across semantic role changes, `Escape` tooltip dismissal, `maximum-scale=5.0` pinch-to-zoom, iOS Safari 16px input auto-zoom prevention, and `<flutter-view>`-scoped `<flt-semantics-placeholder>`.
- Document runtime `debugShowSemanticsNodes` query parameter and `flutter_bootstrap.js` configuration in `accessibility-testing.md`.

Fixes #13963
@flutter-website-bot

flutter-website-bot commented Oct 16, 2026 •

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit 530b705):

https://flutter-docs-prod--docs-pr13987-web-a11y-13963-t75hg5mc.web.app

@kevmoo
kevmoo marked this pull request as ready for review October 16, 2026 22:22
@kevmoo
kevmoo requested review from a team and sfshaza2 as code owners October 16, 2026 22:22
@kevmoo
kevmoo requested a review from flutter-zl October 16, 2026 22:22

@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 updates the Flutter web accessibility documentation to include instructions for enabling semantic node visualization at runtime via flutter_bootstrap.js, details on mobile browser scoping for the accessibility button, and new features introduced in Flutter 3.50 (such as enhanced slider semantics, landmarks, focus preservation, and viewport zoom configurations). The review feedback correctly identifies two misleading technical descriptions: it recommends clarifying that namesRoute is a boolean property rather than a label string to prevent compilation errors, and suggests correcting the non-standard reference to the standard viewport tag with id="flt-viewport".

Comment thread sites/docs/src/content/ui/accessibility/web-accessibility.md Outdated
Comment thread sites/docs/src/content/ui/accessibility/web-accessibility.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[ui/accessibility] Update web-accessibility.md for Flutter 3.50 WCAG 2.1 AA improvements and fix duplicated sentence

2 participants