Skip to content

Fix AppBar title route announcements on iOS and macOS#187621

Draft
hannah-hyj wants to merge 1 commit into
flutter:masterfrom
hannah-hyj:fix-185894
Draft

Fix AppBar title route announcements on iOS and macOS#187621
hannah-hyj wants to merge 1 commit into
flutter:masterfrom
hannah-hyj:fix-185894

Conversation

@hannah-hyj
Copy link
Copy Markdown
Member

Fix: #185894

see discussion in #185894

Previously, from PR #16081 (from April 2018) namesRoute on AppBar.title's Semantics widget was set to null on iOS and macOS to follow iOS conventions.

This PR sets namesRoute to true on the AppBar's title semantics across all platforms, matching standard WCAG 2.4.2 page-titled guidelines.

Pre-launch Checklist

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

If this change needs to override an active code freeze, provide a comment explaining why. The code freeze workflow can be overridden by code reviewers. See pinned issues for any active code freezes with guidance.

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.

@flutter-dashboard flutter-dashboard Bot added the CICD Run CI/CD label Jun 5, 2026
@hannah-hyj hannah-hyj requested a review from chunhtai June 5, 2026 18:41
@github-actions github-actions Bot added framework flutter/packages/flutter repository. See also f: labels. f: material design flutter/packages/flutter/material repository. labels Jun 5, 2026
Copy link
Copy Markdown
Contributor

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

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 simplifies the AppBar title semantics by unconditionally setting the namesRoute flag to true on all platforms when header semantics are not excluded, rather than conditionally setting it based on the target platform. Correspondingly, the unit tests have been updated to verify that the namesRoute flag is non-null across all platforms using TargetPlatformVariant.all(). There are no review comments, and I have no feedback to provide.

@hannah-hyj hannah-hyj added the waiting for code freeze This PR is waiting for a code freeze to resolve. label Jun 5, 2026
@hannah-hyj
Copy link
Copy Markdown
Member Author

converting this to draft because of the code freeze

@hannah-hyj hannah-hyj marked this pull request as draft June 5, 2026 18:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CICD Run CI/CD f: material design flutter/packages/flutter/material repository. framework flutter/packages/flutter repository. See also f: labels. waiting for code freeze This PR is waiting for a code freeze to resolve.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[a11y] AppBar.title is not mapped to the native screen title — screen readers announce it as a heading, not a page title

1 participant