Update Accessibility docs #12513

hannah-hyj · 2025-10-03T20:34:51Z

This PR did

Split Accessibility and Internationalization into two tabs
Update Accessibility docs to 5 parts
- title: Introduction
- title: UI Design & Styling
- title: Assistive technologies
- title: Accessibility testing
- title: Web accessibility
keep old content and add some new content
- title: Introduction
  added standards and regulation
- title: UI Design & Styling
  added pictures and touch target size.
- title: Assistive technologies
  added mobility.
- title: Accessibility testing
  added nothing.
- title: Web accessibility
  added how to opt-in using button or code

Presubmit checklist

If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
This PR uses semantic line breaks
of 80 characters or fewer.

flutter-website-bot · 2025-10-04T00:10:05Z

Visit the preview URL for this PR (updated for commit 69b87bd):

https://flutter-docs-prod--pr12513-refresh-a11y-2dmrp4ce.web.app

sfshaza2

Fixing the broken link.

src/content/ui/accessibility/web-accessibility.md

sfshaza2

@hannah-hyj, this is a FABULOUS update to the accessibility docs! I have some minor edits, to make the text more consistent and so forth (and I previously fixed a broken link), but this is SUPER appreciated!

src/content/ui/accessibility/accessibility-testing.md

src/content/ui/accessibility/index.md

src/content/ui/accessibility/web-accessibility.md

src/content/ui/accessibility/index.md

Fixed two more broken links

sfshaza2 · 2025-10-08T01:04:41Z

OK, I should have anticipated this. All sorts of internal links are breaking because of the new structure of the accessibility docs. I'm done for the day, but I can tackle this tomorrow. For one thing, we should set up redirects in the firebase.json file, so folks that link INTO our docs will end up at least roughly in the right place.

chunhtai · 2025-10-06T22:39:03Z

src/content/ui/accessibility/accessibility-testing.md

+
+* For web:
+    1. Open Chrome DevTools (or similar tools in other browsers)
+    2. Inspect the HTML tree containing the ARIA attributes generated by


html tree under semantics host

do you mean update the wording here to "html tree under semantics host"?

right, because there are multiple div sub tree for other reason, but the only interesting one for semantics is the flt-semantics-host

chunhtai · 2025-10-08T20:55:03Z

src/content/ui/accessibility/assistive-technologies.md

+
+<br/>
+
+Check out the following [video demo][] to see Victor Tsaran,


Feels a bit weird to call out a person's name like this, we should makes thing a bit anonymous

Good point, @chunhtai.

updated, thanks!

chunhtai · 2025-10-08T20:56:36Z

src/content/ui/accessibility/assistive-technologies.md

+When there is text in your app that should be voiced
+with a specific voice, inform the screen reader
+which voice to use by calling [`TextSpan.locale`][].
+Note that `MaterialApp.locale` and `Localizations.override`


They will affect the talkback locale in the next release

same thing for Semantics(localeForSubtree)

updated to "MaterialApp.locale and Localizations.override
will affect screen reader voices starting from flutter 3.38 release." is it correct?

chunhtai · 2025-10-08T21:00:34Z

src/content/ui/accessibility/assistive-technologies.md

+Understanding these tools helps in creating
+apps that are usable by people with diverse physical abilities.
+
+<table class="table table-striped">


Why do we use html instead of markdown?

I'm not sure, but I don't feel strongly enough about it to hold up this PR.

markdown table has no border and i think html table looks better

chunhtai · 2025-10-08T22:15:40Z

src/content/ui/accessibility/accessibility-testing.md

+description: Information on Flutter's accessibility testing.
+---
+
+## Inspecting accessibility support


Somewhere in this page should also mention checking against the public standard like WCAG and VPAT or EAA, ideally links to a self assessment template

added, thanks!

chunhtai · 2025-10-08T22:16:10Z

src/content/ui/accessibility/ui-design-and-styling.md

+
+Both Android and iOS contain system settings to configure the desired font
+sizes used by apps. Flutter text widgets respect this OS setting when
+determining font sizes.


maybe a quick guide on how to adjust them in each devices

chunhtai · 2025-10-08T22:17:11Z

src/content/ui/accessibility/ui-design-and-styling.md

+
+[W3C recommends]: https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html
+
+## Tap target size


we can also mention the rest of https://api.flutter.dev/flutter/dart-ui/AccessibilityFeatures-class.html

src/content/release/whats-new.md

sfshaza2

OK, I think I fixed the broken anchor and (I hope) the build will pass now.

@hannah-hyj, I will let you address @chunhtai's comments. But I think we are getting close!

chunhtai

LGTM, it is well written! I don't have other comment besides these.

chunhtai · 2025-10-09T18:19:48Z

src/content/ui/accessibility/accessibility-testing.md

+
+* For web:
+    1. Open Chrome DevTools (or similar tools in other browsers)
+    2. Inspect the HTML tree containing the ARIA attributes generated by


right, because there are multiple div sub tree for other reason, but the only interesting one for semantics is the flt-semantics-host

chunhtai · 2025-10-09T18:24:13Z

src/content/ui/accessibility/ui-design-and-styling.md

+</div>
+
+
+## Sufficient contrast


should also mention we have guideline test

chunhtai · 2025-10-09T18:25:24Z

src/content/ui/accessibility/ui-design-and-styling.md

+[W3C recommends]: https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html
+
+## Tap target size
+


also here mention we have guideline, or link to the accessibility-testing.md

draft

3e38d3c

hannah-hyj closed this Oct 3, 2025

updates

3185ea3

hannah-hyj changed the title ~~[Draft] Update Accessibility docs~~ Update Accessibility docs Oct 4, 2025

hannah-hyj reopened this Oct 4, 2025

hannah-hyj marked this pull request as ready for review October 4, 2025 00:08

hannah-hyj requested review from a team and sfshaza2 as code owners October 4, 2025 00:08

hannah-hyj added 2 commits October 3, 2025 17:11

lint

3abe491

lint

37d151b

hannah-hyj requested a review from chunhtai October 4, 2025 00:16

sfshaza2 approved these changes Oct 8, 2025

View reviewed changes

src/content/ui/accessibility/web-accessibility.md Show resolved Hide resolved

Update src/content/ui/accessibility/web-accessibility.md

fbbddfa

sfshaza2 approved these changes Oct 8, 2025

View reviewed changes

sfshaza2 and others added 11 commits October 7, 2025 17:35

Update src/content/ui/accessibility/accessibility-testing.md

e25177a

Update src/content/ui/accessibility/accessibility-testing.md

dff07ca

Update src/content/ui/accessibility/accessibility-testing.md

83eae14

Update src/content/ui/accessibility/accessibility-testing.md

d664bcf

Update src/content/ui/accessibility/accessibility-testing.md

655568a

Update src/content/ui/accessibility/index.md

52df8ee

Update src/content/ui/accessibility/index.md

609f508

Update src/content/ui/accessibility/web-accessibility.md

fccde10

Update src/content/ui/accessibility/web-accessibility.md

e26195e

Update src/content/ui/accessibility/web-accessibility.md

b971f5b

remove pictures

eed7e22

sfshaza2 reviewed Oct 8, 2025

View reviewed changes

src/content/ui/accessibility/index.md Show resolved Hide resolved

Update src/content/ui/accessibility/index.md

a3f8e1e

Fixed two more broken links

Fixing internal broken links

8a725d8

chunhtai reviewed Oct 8, 2025

View reviewed changes

sfshaza2 reviewed Oct 8, 2025

View reviewed changes

src/content/release/whats-new.md Outdated Show resolved Hide resolved

Update src/content/release/whats-new.md

a71b9d9

sfshaza2 reviewed Oct 8, 2025

View reviewed changes

resolve comments

83b5f62

hannah-hyj requested a review from chunhtai October 9, 2025 17:08

chunhtai approved these changes Oct 9, 2025

View reviewed changes

hannah-hyj added 2 commits October 9, 2025 12:59

resolve comments

96dd335

fix link

69b87bd

hannah-hyj merged commit 0127ae9 into flutter:main Oct 9, 2025
9 checks passed


		<br/>

		Check out the following [video demo][] to see Victor Tsaran,


		[W3C recommends]: https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html

		## Tap target size

Update Accessibility docs #12513

Update Accessibility docs #12513

Conversation

hannah-hyj commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Presubmit checklist

Uh oh!

flutter-website-bot commented Oct 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sfshaza2 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sfshaza2 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

sfshaza2 commented Oct 8, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sfshaza2 left a comment

Choose a reason for hiding this comment

Uh oh!

chunhtai left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

hannah-hyj commented Oct 3, 2025 •

edited

Loading

flutter-website-bot commented Oct 4, 2025 •

edited

Loading

chunhtai left a comment •

edited

Loading