@@ -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 @@ 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 @@ 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 @@ Naming Prohibited
- Global `aria-*` attributes
+ Otherwise, global `aria-*` attributes
and any `aria-*` attributes applicable to the allowed roles.
@@ -1087,8 +1117,9 @@ 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 @@
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