Skip to content

Commit ea7fbdb

Browse files
authored
Update: hidden attribute clarifications (#507)
* Update: hidden attribute clarifications * update change log
1 parent 4cd9bdc commit ea7fbdb

File tree

1 file changed

+21
-12
lines changed

1 file changed

+21
-12
lines changed

index.html

+21-12
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,10 @@
6464
the following substantive additions and/or corrections have been proposed:
6565
</p>
6666
<ul>
67+
<li>
68+
<a href="https://github.com/w3c/html-aria/pull/507">13 December 2024 - Addition:</a>
69+
Clarify the allowance for `aria-hidden` when used with the `hidden` attribute.
70+
</li>
6771
<li>
6872
<a href="https://github.com/w3c/html-aria/pull/489">4 October 2023 - Addition:</a>
6973
Update the button element and input type=button,image,reset,submit elements to allow the `separator` role.
@@ -3648,7 +3652,8 @@ <h3 id="docconformance-attr">
36483652
Use the `disabled` attribute on any element that is allowed the `disabled` attribute in HTML.
36493653
</p>
36503654
<p>
3651-
Authors MAY use the <a data-cite="wai-aria-1.2#aria-disabled">`aria-disabled`</a> 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</a>.
3655+
Authors MAY use the <a data-cite="wai-aria-1.2#aria-disabled">`aria-disabled`</a> attribute on any element that is allowed the `disabled` attribute in HTML,
3656+
or any element with a WAI-ARIA role which allows the `aria-disabled` attribute</a>.
36523657
</p>
36533658
<p>
36543659
Authors SHOULD NOT use `aria-disabled="true"` on any element which also has a `disabled` attribute.
@@ -3667,19 +3672,22 @@ <h3 id="docconformance-attr">
36673672
</td>
36683673
<td>
36693674
<p>
3670-
Authors MAY use the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on any HTML element that allows <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>, with the following exception:
3675+
Authors MAY use the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on any HTML element that allows <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> to
3676+
be specified, with the exception of focusable elements and the <a href="#el-body">`body`</a> element.
36713677
</p>
36723678
<p>
3673-
Authors SHOULD NOT use the `aria-hidden="true"` attribute on any element which also has a `hidden` attribute.
3674-
</p>
3675-
3676-
<!-- this will be covered as part of issue 221 -->
3677-
<!-- <p>
3678-
Authors MUST NOT use `aria-hidden="true"` on an element that can receive keyboard focus, or on an ancestor element to an element or elements which can receive keyboard focus.
3679+
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.
36793680
</p>
3680-
<p>
3681-
Any elements which can receive keyboard focus, interactive elements or otherwise, MUST have their ability to receive keyboard focus removed while the `aria-hidden="true"` attribute is present. For instance, by using `tabindex="-1"` on any focusable elements with `aria-hidden="true"`, or setting `tabindex="-1"` to focusable elements that are descendants of an `aria-hidden="true"` containing element.
3682-
</p> -->
3681+
<div class="note">
3682+
A focusable element is any element which can be focused by use of keyboard or pointer device. Focusable elements are not always elements which
3683+
can be tabbed to via a keyboard. For instance, an element with `tabindex="-1"` is focusable but is not a tabbable element.
3684+
</div>
3685+
<div class="note">
3686+
Using `aria-hidden="true"` on an element that has the `hidden` attribute is at best an unnecessary redundancy. At worst its usage can
3687+
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.
3688+
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
3689+
technology when it is found via a browser's in-page find feature and visually rendered to users.
3690+
</div>
36833691
</td>
36843692
</tr>
36853693
<tr id="att-placeholder" tabindex="-1">
@@ -3695,7 +3703,8 @@ <h3 id="docconformance-attr">
36953703
`placeholder` attribute in HTML.
36963704
</p>
36973705
<p>
3698-
Authors MAY use the <a data-cite="wai-aria-1.2#aria-placeholder">`aria-placeholder`</a> 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.
3706+
Authors MAY use the <a data-cite="wai-aria-1.2#aria-placeholder">`aria-placeholder`</a> attribute on any element that is allowed the `placeholder` attribute in HTML,
3707+
or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute.
36993708
</p>
37003709
<p>
37013710
Authors MUST NOT use the `aria-placeholder` attribute on any element which also has a `placeholder` attribute.

0 commit comments

Comments
 (0)