Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update: hidden attribute clarifications #507

Open
wants to merge 3 commits into
base: gh-pages
Choose a base branch
from
Open

Update: hidden attribute clarifications #507

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4698ccd
Update: hidden attribute clarifications
scottaohara Feb 16, 2024
11f3759
Update index.html
scottaohara Feb 16, 2024
ffe41cf
Merge branch 'gh-pages' into hidden-attribute-clarifications
scottaohara Mar 25, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 17 additions & 12 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3647,7 +3647,8 @@ <h3 id="docconformance-attr">
Use the `disabled` attribute on any element that is allowed the `disabled` attribute in HTML.
</p>
<p>
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>.
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>.
</p>
<p>
Authors SHOULD NOT use `aria-disabled="true"` on any element which also has a `disabled` attribute.
Expand All @@ -3666,19 +3667,22 @@ <h3 id="docconformance-attr">
</td>
<td>
<p>
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:
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
be specified, with the exception of focusable elements and the <a href="#el-body">`body`</a> element.
</p>
<p>
Authors SHOULD NOT use the `aria-hidden="true"` attribute on any element which also has a `hidden` attribute.
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.
</p>

<!-- this will be covered as part of issue 221 -->
<!-- <p>
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.
</p>
<p>
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.
</p> -->
<div class="note">
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.
</div>
<div class="note">
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.
</div>
</td>
</tr>
<tr id="att-placeholder" tabindex="-1">
Expand All @@ -3694,7 +3698,8 @@ <h3 id="docconformance-attr">
`placeholder` attribute in HTML.
</p>
<p>
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.
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.
</p>
<p>
Authors MUST NOT use the `aria-placeholder` attribute on any element which also has a `placeholder` attribute.
Expand Down
Loading