diff --git a/index.html b/index.html index 8a82400e..14cbadb2 100644 --- a/index.html +++ b/index.html @@ -218,7 +218,7 @@

unnecessary and can result in cross-platform issues. For instance, preventing the element from correctly exposing its state, and forcing the role of `button`, when it might otherwise be exposed with a - different role. + platform or browser specific role.

           <details>
@@ -283,6 +283,21 @@ 

MUST NOT overwrite the implicit ARIA semantics, or native semantics of the HTML element.

+
+

+ [[wai-aria-1.2|WAI-ARIA]] identifies roles which have + prohibited states and properties. + These roles do not allow certain WAI-ARIA attributes to be specified by authors. + HTML elements which expose these implicit WAI-ARIA roles also prohibit authors from + specifying these WAI-ARIA attributes. +

+

+ Elements which are identified as Naming prohibited + are elements authors MUST NOT specify an `aria-label` or `aria-labelledby` + attribute, unless the element allows for its implicit role to be overwritten by an explicit + WAI-ARIA role which allows naming from authors. For more information see [[[#docconformance-naming]]]. +

+

While setting an ARIA `role` and/or `aria-*` attribute that matches the implicit ARIA semantics is NOT RECOMMENDED, in some @@ -291,8 +306,7 @@

ARIA semantics.

- While it is conforming to use [[[dpub-aria-1.0]]] `role` values as outlined in the following table, - the current support for exposing the semantics of these values to users of assistive technology is close to non-existent. + While it is conforming to use [[[dpub-aria-1.0]]] `role` values as outlined in the following table, the current support for exposing the semantics of these values to users of assistive technology is close to non-existent.

@@ -1153,8 +1182,9 @@

`switch` or `textbox`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1219,8 +1249,9 @@

`none` or `presentation`

+

Naming Prohibited if exposed as `generic`.

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1236,8 +1267,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1289,8 +1321,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1845,8 +1878,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1862,8 +1896,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1879,8 +1914,9 @@

No `role`

+

Naming Prohibited

- Global `aria-*` attributes. + Otherwise, global `aria-*` attributes.

@@ -1895,8 +1931,9 @@

No `role`

+

Naming Prohibited

- Global `aria-*` attributes. + Otherwise, global `aria-*` attributes.

@@ -1988,8 +2025,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2235,8 +2273,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2284,8 +2323,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2323,8 +2363,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2357,8 +2398,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2391,8 +2433,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2408,8 +2451,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2570,8 +2614,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2600,8 +2645,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2617,8 +2663,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2647,8 +2694,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2681,8 +2729,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2814,8 +2863,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2940,8 +2990,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -2988,8 +3039,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -3088,6 +3140,43 @@

</figure> +
+

+ Requirements for use of ARIA attributes to name elements +

+ +

+ Authors MAY use `aria-label` and `aria-labelledby` attributes to specify accessible names for elements which have an implicit or explicit ARIA role which allows naming from authors. [[[wai-aria-1.2]]] defines roles which allow naming from authors as well as roles where author naming is prohibited. +

+

+ Authors MUST NOT specify `aria-label` or `aria-labelledby` on elements with implicit WAI-ARIA roles which cannot be named. HTML elements whose implicit WAI-ARIA roles prohibit naming from authors are identified in [[[#docconformance]]]. +

+

+ The following markup example demonstrates a selection of HTML elements with implicit ARIA roles that prohibit naming from authors. +

+
+            <!-- DO NOT do the following! -->
+            <p aria-label="...">...</p>
+
+            <span aria-label="...">...<span>
+
+            <code aria-label="...">...<code>
+
+            <div aria-labelledby="...">...</div>
+          
+

+ The following markup example demonstrates elements which have explicit WAI-ARIA roles which allow naming from authors. Due to the explicit roles specified on these elements, `aria-label` and `aria-labelledby` attributes are allowed. +

+
+            <p role="link" tabindex="0" aria-label="...">...</p>
+
+            <span role="button" tabindex="0" aria-label="...">...<span>
+
+            <div role="article" aria-labelledby="...">...</div>
+          
+ +

Requirements for use of ARIA attributes in place of equivalent HTML attributes

@@ -368,8 +382,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -385,9 +400,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes and - any `aria-*` attributes applicable to the allowed roles. + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -402,8 +417,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -438,8 +454,9 @@

`button` or `link`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -535,8 +552,9 @@

Otherwise, any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -554,8 +572,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -584,8 +603,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -601,8 +621,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -635,8 +656,9 @@

No `role`

+

Naming Prohibited

- Global `aria-*` attributes. + Otherwise, global `aria-*` attributes.

@@ -714,8 +736,9 @@

No `role`

+

Naming Prohibited

- Global `aria-*` attributes. + Otherwise, global `aria-*` attributes.

@@ -730,8 +753,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -747,8 +771,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -790,8 +815,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -842,8 +868,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -913,8 +940,9 @@

Then only `presentation` or `none`.

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -969,8 +997,9 @@

Any `role`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1031,8 +1060,9 @@

`none` or `presentation`

+

Naming Prohibited

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1087,8 +1117,9 @@

DPub Role: `doc-footnote`

+

Naming Prohibited if exposed as `generic`.

- Global `aria-*` attributes + Otherwise, global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

@@ -1099,13 +1130,8 @@

- If the [^form^] element has an - accessible name: role=form

-

- Otherwise, no corresponding role -

@@ -1118,6 +1144,9 @@

Global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

+

+ A `form` is not exposed as a landmark region unless it has been provided an accessible name. +