diff --git a/index.html b/index.html index 7cfffbaa..c1b3530a 100644 --- a/index.html +++ b/index.html @@ -210,6 +210,70 @@

Exposing HTML Features That Do Not Directly Map to Accessibility APIs

API properties in the [[core-aam-1.2]].

+
+

Exposing HTML Features With Contextual Roles

+

+ An element with a contextual role is one whose implicit WAI-ARIA role semantics are based on its anestral accessibility tree relationship to another element or elements. Or, an element whose computed role is reliant on whether the element has been provided an accessible name. +

+

+ For instance, an element that is an accessibility child of its required accessibility parent would expose a computed role that was + appropriate for this context. Where the same element might be used in another context with a different accessibility parent, and would therefore expose a computed role + appropriate for that context. +

+

+ When the conditions for an element's contextual role are not met, it will commonly expose a computed role of `generic` or with a minimum role, if applicable. +

+
+

Previously, the concept of a contextual role was loosely referred to as an element's "scoped" relationship to another element.

+
+
+

+ A li element has an implicit WAI-ARIA role mapping of listitem only when the element is an accessibility child of a + menu, ol or ul element that has not had its `list` role mapping suppressed. +

+
<ul>
+        <li>...</li> <!-- role=listitem -->
+      </ul> 
+      <article>
+        ...
+        <li>...</li> <!-- not role=listitem -->
+        ...
+
+
+

+ An aside element has an implicit WAI-ARIA role mapping of complementary only when the element is an accessibility child of + the body or main elements, or if the aside has been provided an accessible name. +

+
<body>
+        ...
+        <main>
+          ...
+          <article>
+            <aside>...</aside> <!-- not role=complementary -->
+            ...
+            <aside aria-label=named>...</aside> <!-- role=complementary -->
+          </article>
+          ...
+          <aside>...</aside> <!-- role=complementary -->
+        </main>
+        <aside>...</aside> <!-- role=complementary -->
+        ...
+        <footer>
+          ...
+          <aside>...</aside> <!-- not role=complementary -->
+        </footer>
+
+ +
+

A section element has an implicit WAI-ARIA role mapping of region only when the element is provided an accessible name.

+ +
<section title="accessible name">...</section> <!-- role=region -->
+      ...
+      <section aria-label="accessible name">...</section> <!-- role=region -->
+      ...
+      <section>...</section> <!-- not role=region -->
+
+

HTML Element Role Mappings