flutter-accessibility-audit

SKILL.md

Implementing Flutter Accessibility

Contents

Managing Semantics

Auditing Accessibility

Debugging the Semantics Tree

Examples

Managing Semantics

Rely on Flutter's standard widgets (e.g., TabBar, MenuAnchor) for automatic semantic role assignment whenever possible. When building custom components or overriding default behaviors, explicitly define the UI element's purpose using the Semantics widget.

Wrap custom UI components in a Semantics widget.

Assign the appropriate SemanticsRole enum value to the role property to define the element's purpose (e.g., button, list, heading).

If building for Flutter Web, note that Flutter translates these roles into corresponding ARIA roles in the HTML DOM.

Enable web accessibility explicitly. It is disabled by default for performance. Either instruct users to press the invisible aria-label="Enable accessibility" button, or force it programmatically in your main() function.

Auditing Accessibility

Implement the following workflows to verify that your application meets accessibility standards.