From 4698ccd064c4f98adf016896a0d688b52d8f990f Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 16 Feb 2024 09:15:18 -0500 Subject: [PATCH 1/3] Update: hidden attribute clarifications --- index.html | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/index.html b/index.html index f8d03a8..a182ba1 100644 --- a/index.html +++ b/index.html @@ -3641,7 +3641,8 @@

Use the `disabled` attribute on any element that is allowed the `disabled` attribute in HTML.

- Authors MAY use the `aria-disabled` attribute on any element that is allowed the `disabled` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-disabled` attribute. + Authors MAY use the `aria-disabled` attribute on any element that is allowed the `disabled` attribute in HTML, + or any element with a WAI-ARIA role which allows the `aria-disabled` attribute.

Authors SHOULD NOT use `aria-disabled="true"` on any element which also has a `disabled` attribute. @@ -3660,19 +3661,22 @@

- Authors MAY use the `aria-hidden` attribute on any HTML element that allows global `aria-*` attributes, with the following exception: + Authors MAY use the `aria-hidden` attribute on any HTML element that allows global `aria-*` attributes to + be specified, with the exception of focusable elements and the `body` element.

- Authors SHOULD NOT use the `aria-hidden="true"` attribute on any element which also has a `hidden` attribute. + It is NOT RECOMMENDED to use `aria-hidden="true"` on any element which also has the `hidden` attribute specified.

- - - +
+ A focusable element is any element which can be focused by use of keyboard or pointer device. Focusable elements are not always elements which + can be tabbed to via a keyboard. For instance, an element with `tabindex="-1"` is focusable but is not a tabbable element. +
+
+ Using `aria-hidden="true"` on an element that has the `hidden` attribute is at best an unnecessary redundancy. At worst its usage can + prevent access to the content if the `hidden` attribute's default UA style of `display: none` has been purposeuflly overwritten by an author or user style sheet. + Finally, if the `hidden` attribute has the value of `until-found`, the use of `aria-hidden=true` will prevent this content from being discoverable to users of assistive + technology when it is found via a browser's in-page find feature and visually rendered to users. +
@@ -3688,7 +3692,8 @@

`placeholder` attribute in HTML.

- Authors MAY use the `aria-placeholder` attribute on any element that is allowed the `placeholder` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute. + Authors MAY use the `aria-placeholder` attribute on any element that is allowed the `placeholder` attribute in HTML, + or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute.

Authors MUST NOT use the `aria-placeholder` attribute on any element which also has a `placeholder` attribute. From 11f37596c1ce73a6a0d389a59eb31c2cde295b1f Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 16 Feb 2024 09:44:59 -0500 Subject: [PATCH 2/3] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index a182ba1..548ffbe 100644 --- a/index.html +++ b/index.html @@ -3665,7 +3665,7 @@

be specified, with the exception of focusable elements and the `body` element.

- It is NOT RECOMMENDED to use `aria-hidden="true"` on any element which also has the `hidden` attribute specified. + It is generally NOT RECOMMENDED for authors to use `aria-hidden="true"` on any element which also has the `hidden` attribute specified. However, authors MUST NOT use `aria-hidden="true"` on any element which also has the `hidden` attribute specified in the `until-found` state.

A focusable element is any element which can be focused by use of keyboard or pointer device. Focusable elements are not always elements which From a5ed1c66e5f6462b32ceabf1933d642681252cc4 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 13 Dec 2024 12:45:50 -0500 Subject: [PATCH 3/3] change log --- index.html | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/index.html b/index.html index 4830577..0b5c7cd 100644 --- a/index.html +++ b/index.html @@ -64,6 +64,10 @@ the following substantive additions and/or corrections have been proposed: