Skip to content

Commit

Permalink
Merge branch 'gh-pages' into img-allow-math-role
Browse files Browse the repository at this point in the history
  • Loading branch information
@scottaohara
scottaohara authored Dec 16, 2024
2 parents d70ee10 + 7f7718c commit b691826
Show file tree
Hide file tree
Showing 2 changed files with 41 additions and 24 deletions.
64 changes: 40 additions & 24 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,14 @@
the following substantive additions and/or corrections have been proposed:
</p>
<ul>
<li>
<a href="https://github.com/w3c/html-aria/pull/533">13 December 2024 - Addition:</a>
Update to include the `image` role as preferred synonym to the `img` role.
</li>
<li>
<a href="https://github.com/w3c/html-aria/pull/507">13 December 2024 - Addition:</a>
Clarify the allowance for `aria-hidden` when used with the `hidden` attribute.
</li>
<li>
<a href="https://github.com/w3c/html-aria/pull/489">4 October 2023 - Addition:</a>
Update the button element and input type=button,image,reset,submit elements to allow the `separator` role.
Expand Down Expand Up @@ -487,7 +495,7 @@ <h2 id="docconformance">
While it is conforming to use [[[dpub-aria-1.0]]] `role` values as outlined in the following table, the current support for
exposing the semantics of these values to users of assistive technology is close to non-existent.
</p>
<table class="simple">
<table class="data">
<caption>
Rules of ARIA attribute usage by HTML element
</caption>
Expand Down Expand Up @@ -594,7 +602,7 @@ <h2 id="docconformance">
</td>
<td>
<p>
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used.
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> is NOT RECOMMENDED.
</p>
<p>
Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
Expand Down Expand Up @@ -1213,6 +1221,7 @@ <h2 id="docconformance">
<a href="#index-aria-application">`application`</a>,
<a href="#index-aria-document">`document`</a>,
<a href="#index-aria-img">`img`</a>,
<a href="#index-aria-img">`image`</a>,
<a href="#index-aria-none">`none`</a>
or <a href="#index-aria-presentation">`presentation`</a>.
</p>
Expand Down Expand Up @@ -1481,7 +1490,7 @@ <h2 id="docconformance">
</td>
<td>
<p>
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used.
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> is NOT RECOMMENDED.
</p>
<p>
Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
Expand Down Expand Up @@ -1559,6 +1568,7 @@ <h2 id="docconformance">
<a href="#index-aria-application">`application`</a>,
<a href="#index-aria-document">`document`</a>,
<a href="#index-aria-img">`img`</a>,
<a href="#index-aria-img">`image`</a>,
<a href="#index-aria-none">`none`</a>
or <a href="#index-aria-presentation">`presentation`</a>.
</p>
Expand All @@ -1577,7 +1587,7 @@ <h2 id="docconformance">
<td>
If the `img` has non-empty [^img/alt^] (`alt="some text"`) or an accessible name is provided another
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming method</a>:<br>
<code>role=<a href="#index-aria-img">img</a></code>
<code>role=<a href="#index-aria-img">img or image</a></code>
</td>
<td>
<p>
Expand Down Expand Up @@ -1605,7 +1615,7 @@ <h2 id="docconformance">
<a href="#index-aria-switch">`switch`</a>,
<a href="#index-aria-tab">`tab`</a> or
<a href="#index-aria-treeitem">`treeitem`</a>.
(<code><a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.)
(<code><a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
</p>
<p>
DPub Role:
Expand All @@ -1632,7 +1642,7 @@ <h2 id="docconformance">
<p id="el-img-no-alt" tabindex="-1">
If the `img` <a data-cite="html/images.html#unknown-images">lacks an `alt` attribute</a> and lacks any other
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming methods</a>:<br>
<code>role=<a href="#index-aria-img">img</a></code>
<code>role=<a href="#index-aria-img">img or image</a></code>
</p>
</div>
</td>
Expand All @@ -1642,7 +1652,7 @@ <h2 id="docconformance">
If the `img` has no `alt` attribute or accessible name:
<a><strong class="nosupport">No `role`</strong></a> other than the
<code>role=<a href="#index-aria-none">none</a></code> or <code><a href="#index-aria-presentation">presentation</a></code> roles.
(<code>role=<a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.)
(<code>role=<a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
</p>
<p>
If the `img` has an empty `alt=""` attribute and no `aria-label` or `aria-labelledby` attributes to provide it an accessible name:
Expand Down Expand Up @@ -2476,8 +2486,9 @@ <h2 id="docconformance">
<p>
Roles:
<a href="#index-aria-application">`application`</a>,
<a href="#index-aria-document">`document`</a>
or <a href="#index-aria-img">`img`</a>.
<a href="#index-aria-document">`document`</a>,
<a href="#index-aria-img">`img`</a>
or <a href="#index-aria-img">`image`</a>.
</p>
<p>
<a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and
Expand Down Expand Up @@ -3594,7 +3605,7 @@ <h3 id="docconformance-attr">
requirements for using the `aria-*` attributes that supply the same
<a>implicit ARIA semantics</a>.
</p>
<table class="simple">
<table class="data">
<caption>
Rules of ARIA attribute usage by HTML feature
</caption>
Expand Down Expand Up @@ -3652,7 +3663,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 @@ -3671,19 +3683,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 @@ -3699,7 +3714,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 Expand Up @@ -4002,7 +4018,7 @@ <h2>
Additionally, there are certain roles which [[[wai-aria-1.2]]] has specified specific requirements for their allowed descendants. These have been identified in column 3 (Descendant allowances) by indicating to "Refer to the 'Required Owned Elements'" for those particular roles.
</p>

<table id="aria-table" class="simple">
<table id="aria-table" class="data">
<caption>
Allowed descendants of ARIA roles
</caption>
Expand Down Expand Up @@ -4411,7 +4427,7 @@ <h2>
</tr>
<tr>
<th tabindex="-1" id="index-aria-img">
<a data-cite="wai-aria-1.2#img">`img`</a>
<a data-cite="wai-aria-1.2#img">`img` or `image`</a>
</th>
<td>
<ul>
Expand Down
1 change: 1 addition & 0 deletions makeup.css
View file
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,7 @@ table td ul {
so these updates were made to make these work better in
this spec. */
span.addition.proposed,
span.addition.correction,
span.correction.proposed,
span.amendment.proposed {
padding: .125em .25em;
Expand Down

0 comments on commit b691826

Please sign in to comment.