diff --git a/html-aam/index.html b/html-aam/index.html index 7187c22bb..8b7845b0d 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -191,6 +191,27 @@

Exposing HTML Features That Do Not Directly Map to Accessibility APIs

the [[core-aam-1.2]].

+
+

Exposing HTML Features That Require a Minimum Role

+

+ A minimum role is the equivalent WAI-ARIA role an element will map to if the element does not have a more specific implicit role or platform role mappings, e.g., a non-generic + role. This can help ensure that users of assistive technologies get the best possible experience for commonly-used and valid HTML markup where otherwise a role would not be exposed. +

+

A minimum role is provided when all of the following conditions are true:

+ +

+ The HTML Attribute State and Property Mappings section identifies the specific global attributes which would require an element map + to a minimum role. +

+

+ When these conditions are met, the browser MUST expose an object using the mappings defined in CORE-AAM for the specified minimum role. If the element has multiple attributes specified which + require a minimum role be returned as the computed role for the element, prioritize the more specific role in the ARIA taxonomy. +

+

HTML Element Role Mappings

+ +

Platform API mapping requirements

+