Accessibility · Cluster
Semantics and the A11y Tree
Roles, names, and computed structure.
- 01 How a Document Becomes an Accessibility Tree Which DOM nodes a browser exposes to assistive technology, which it discards, and why ignored containers are flattened instead of deleted.
- 02 The Order of Sources in Accessible Name Computation How an accessible name is assembled from aria-labelledby, aria-label, host-language labels, and content, and where the recursion stops.
- 03 Implicit Roles and How Role Conflicts Resolve How browsers derive a role from element and attributes, what happens when an explicit role token disagrees with the host language, and why some overrides are rejected.
- 04 Mapping ARIA Roles onto Platform Accessibility APIs How a role token becomes an MSAA role, an AXRole, or an AT-SPI role, which properties carry states, and where the mappings diverge.
- 05 Static Text Objects and the Text Interface Why paragraphs become single text objects, how character offsets and range queries work, and what happens when a text run is split by inline structure.
- 06 Hidden Subtrees and Presentational Roles The difference between aria-hidden, display none, visibility hidden, and role presentation, and which of them removes a node from the tab order.
- 07 Focus Order and the Accessibility Tree How tabindex, DOM order, and the tree order diverge, and why the tab sequence and the reading order are computed from different structures.
- 08 Accessibility Tree Invalidation and Event Coalescing How engines detect that the tree is stale, what work happens before platform events fire, and why a burst of mutations can produce a single announcement.
- 09 Required Owned Elements and Structural Constraints Which roles require children, which require a parent, how engines repair an orphaned widget, and why the repair changes reading order.
- 10 Container Roles and Nested Structure How group, region, and composite containers nest, what nesting does to landmark and heading navigation, and when a wrapper should carry a role at all.