From 9644e8ba1267b7f63d5faa0347d7c739c3b312ce Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 4 Nov 2022 13:01:44 -0400 Subject: [PATCH] Revisions to 'any role' term description related to https://github.com/validator/validator/issues/1425 and https://github.com/w3c/html-aria/pull/436 cc @stevefaulkner @sideshowbarker as per my comment in #436, here is part of the update I had planned to do to help address this. it is also related to https://github.com/w3c/html-aria/issues/358, but does NOT close that issue completely. I'm leaving in place the updates that Mike made in the merged PR, but likely will need to revise that column later on as well, so those specific call outs may be moved or changed in the future. Any further changes we would like to see to this text to help here? --- index.html | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/index.html b/index.html index 6b9ea3ad..f19cc46b 100644 --- a/index.html +++ b/index.html @@ -168,7 +168,7 @@

ARIA semantics that extend and diverge from HTML

attribute, allowing for an aural UI that will match the visual presentation of the control.

- In the following example, a `button` allows for a user to toggle the state of a + In the following example, a `button` element allows for a user to toggle the state of a setting within a web application. The `aria-pressed` attribute is used to augment the `button` element. When in the "pressed" state that information can be exposed to users of assistive technologies. @@ -341,10 +341,9 @@

(role, states, and properties) given in the cell in the second column of the same row. The third cell in each row defines the ARIA `role` values and `aria-*` attributes which authors MAY specify on the element. Where a cell in the third column includes the term Any `role` - it indicates that any `role` value apart from the implicit ARIA semantics `role` value, - MAY be used, unless it is the `generic` role or a role - deprecated by ARIA. - The `generic` role and roles deprecated by ARIA SHOULD NOT be used by authors. + it indicates that any `role` value MAY be used on the element. However, + it is NOT RECOMMENDED for authors to specify the implicit role of the element, the `generic` role, or a role + deprecated by ARIA on these elements. If a cell in the third column includes the term No `role` it indicates that authors MUST NOT overwrite the implicit ARIA semantics, or native semantics of the HTML element.