Skip to content

Commit 744469b

Browse files
scottaoharascottaohara
authored
Merge branch 'gh-pages' into patch-1
2 parents 794e845 + 1cf4fc1 commit 744469b

File tree

5 files changed

+61
-45
lines changed

5 files changed

+61
-45
lines changed

‎CONTRIBUTING.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Web Applications Working Group
1+
# Contributing to the ARIA in HTML Specification
22

33
Contributions to this repository are intended to become part of Recommendation-track documents
44
governed by the [W3C Patent Policy](http://www.w3.org/Consortium/Patent-Policy/) and

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ARIA in HTML Specification
22

3-
This is the repository for [ARIA in HTML (html-aria)](https://w3c.github.io/html-aria/).
3+
This is the repository for [ARIA in HTML (html-aria)](https://w3c.github.io/html-aria/). This is developed by the [ARIA Working Group](http://www.w3.org/WAI/ARIA/). The W3C staff contact is Daniel Montalvo.
44

55
If you would like to contribute, please [read the contributing document](https://github.com/w3c/html-aria/blob/gh-pages/CONTRIBUTING.md), and review the [W3C Code of Ethics and Professional Conduct](https://www.w3.org/Consortium/cepc/).
66

‎index.html‎

Lines changed: 56 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,18 @@
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/525">23 December 2024 - Addition:</a>
69+
Update the <a href="#el-img">`img`</a> element to allow the `math` role.
70+
</li>
71+
<li>
72+
<a href="https://github.com/w3c/html-aria/pull/533">13 December 2024 - Addition:</a>
73+
Update to include the `image` role as preferred synonym to the `img` role.
74+
</li>
75+
<li>
76+
<a href="https://github.com/w3c/html-aria/pull/507">13 December 2024 - Addition:</a>
77+
Clarify the allowance for `aria-hidden` when used with the `hidden` attribute.
78+
</li>
6779
<li>
6880
<a href="https://github.com/w3c/html-aria/pull/489">4 October 2023 - Addition:</a>
6981
Update the button element and input type=button,image,reset,submit elements to allow the `separator` role.
@@ -487,7 +499,7 @@ <h2 id="docconformance">
487499
While it is conforming to use [[[dpub-aria-1.0]]] `role` values as outlined in the following table, the current support for
488500
exposing the semantics of these values to users of assistive technology is close to non-existent.
489501
</p>
490-
<table class="simple">
502+
<table class="data">
491503
<caption>
492504
Rules of ARIA attribute usage by HTML element
493505
</caption>
@@ -594,7 +606,7 @@ <h2 id="docconformance">
594606
</td>
595607
<td>
596608
<p>
597-
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used.
609+
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> is NOT RECOMMENDED.
598610
</p>
599611
<p>
600612
Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
@@ -632,7 +644,7 @@ <h2 id="docconformance">
632644
<p>
633645
Roles:
634646
<a href="#index-aria-button">`button`</a>
635-
or <a href="#index-aria-link">`link`</a>. (<code><a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT BE USED.)
647+
or <a href="#index-aria-link">`link`</a>. (<code><a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT be used.)
636648
</p>
637649
<p><a>Naming Prohibited</a></p>
638650
<p>
@@ -1213,6 +1225,7 @@ <h2 id="docconformance">
12131225
<a href="#index-aria-application">`application`</a>,
12141226
<a href="#index-aria-document">`document`</a>,
12151227
<a href="#index-aria-img">`img`</a>,
1228+
<a href="#index-aria-img">`image`</a>,
12161229
<a href="#index-aria-none">`none`</a>
12171230
or <a href="#index-aria-presentation">`presentation`</a>.
12181231
</p>
@@ -1480,7 +1493,7 @@ <h2 id="docconformance">
14801493
</td>
14811494
<td>
14821495
<p>
1483-
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used.
1496+
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> is NOT RECOMMENDED.
14841497
</p>
14851498
<p>
14861499
Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
@@ -1558,6 +1571,7 @@ <h2 id="docconformance">
15581571
<a href="#index-aria-application">`application`</a>,
15591572
<a href="#index-aria-document">`document`</a>,
15601573
<a href="#index-aria-img">`img`</a>,
1574+
<a href="#index-aria-img">`image`</a>,
15611575
<a href="#index-aria-none">`none`</a>
15621576
or <a href="#index-aria-presentation">`presentation`</a>.
15631577
</p>
@@ -1570,20 +1584,24 @@ <h2 id="docconformance">
15701584
<tr>
15711585
<th id="el-img" tabindex="-1">
15721586
<div class="correction proposed">
1573-
[^img^] with an accessible name.
1587+
[^img^]
15741588
</div>
15751589
</th>
15761590
<td>
1577-
If the `img` has non-empty [^img/alt^] (`alt="some text"`) or an accessible name is provided another
1578-
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming method</a>:<br>
1579-
<code>role=<a href="#index-aria-img">img</a></code>
1591+
If the `img` has non-empty [^img/alt^] (`alt="some text"`) or an accessible name is provided by another
1592+
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming method</a>,
1593+
or the `img` has no `alt` and has not been provided a name:<br>
1594+
<code>role=<a href="#index-aria-img">img or image</a></code>
15801595
</td>
15811596
<td>
15821597
<p>
15831598
Roles:
15841599
<a href="#index-aria-button">`button`</a>,
15851600
<a href="#index-aria-checkbox">`checkbox`</a>,
15861601
<a href="#index-aria-link">`link`</a>,
1602+
<span class="correction">
1603+
<a href="#index-aria-math">`math`</a>,
1604+
</span>
15871605
<a href="#index-aria-menuitem">`menuitem`</a>,
15881606
<a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>,
15891607
<a href="#index-aria-menuitemradio">`menuitemradio`</a>,
@@ -1600,7 +1618,8 @@ <h2 id="docconformance">
16001618
<a href="#index-aria-slider">`slider`</a>,
16011619
<a href="#index-aria-switch">`switch`</a>,
16021620
<a href="#index-aria-tab">`tab`</a> or
1603-
<a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.)
1621+
<a href="#index-aria-treeitem">`treeitem`</a>.
1622+
(<code><a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
16041623
</p>
16051624
<p>
16061625
DPub Role:
@@ -1614,7 +1633,7 @@ <h2 id="docconformance">
16141633
</tr>
16151634
<tr>
16161635
<th id="el-img-no-name" tabindex="-1">
1617-
[^img^] with no accessible name.
1636+
[^img^] with no accessible name
16181637
</th>
16191638
<td>
16201639
<div class="proposed correction">
@@ -1627,7 +1646,7 @@ <h2 id="docconformance">
16271646
<p id="el-img-no-alt" tabindex="-1">
16281647
If the `img` <a data-cite="html/images.html#unknown-images">lacks an `alt` attribute</a> and lacks any other
16291648
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming methods</a>:<br>
1630-
<code>role=<a href="#index-aria-img">img</a></code>
1649+
<code>role=<a href="#index-aria-img">img or image</a></code>
16311650
</p>
16321651
</div>
16331652
</td>
@@ -1637,7 +1656,7 @@ <h2 id="docconformance">
16371656
If the `img` has no `alt` attribute or accessible name:
16381657
<a><strong class="nosupport">No `role`</strong></a> other than the
16391658
<code>role=<a href="#index-aria-none">none</a></code> or <code><a href="#index-aria-presentation">presentation</a></code> roles.
1640-
(<code>role=<a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.)
1659+
(<code>role=<a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
16411660
</p>
16421661
<p>
16431662
If the `img` has an empty `alt=""` attribute and no `aria-label` or `aria-labelledby` attributes to provide it an accessible name:
@@ -2414,7 +2433,8 @@ <h2 id="docconformance">
24142433
</p>
24152434
<p>
24162435
Otherwise, any
2417-
<a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>.
2436+
<a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
2437+
and any other `aria-*` attributes applicable to the `meter` role.
24182438
</p>
24192439
</td>
24202440
</tr>
@@ -2470,8 +2490,9 @@ <h2 id="docconformance">
24702490
<p>
24712491
Roles:
24722492
<a href="#index-aria-application">`application`</a>,
2473-
<a href="#index-aria-document">`document`</a>
2474-
or <a href="#index-aria-img">`img`</a>.
2493+
<a href="#index-aria-document">`document`</a>,
2494+
<a href="#index-aria-img">`img`</a>
2495+
or <a href="#index-aria-img">`image`</a>.
24752496
</p>
24762497
<p>
24772498
<a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and
@@ -3588,7 +3609,7 @@ <h3 id="docconformance-attr">
35883609
requirements for using the `aria-*` attributes that supply the same
35893610
<a>implicit ARIA semantics</a>.
35903611
</p>
3591-
<table class="simple">
3612+
<table class="data">
35923613
<caption>
35933614
Rules of ARIA attribute usage by HTML feature
35943615
</caption>
@@ -3646,7 +3667,8 @@ <h3 id="docconformance-attr">
36463667
Use the `disabled` attribute on any element that is allowed the `disabled` attribute in HTML.
36473668
</p>
36483669
<p>
3649-
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>.
3670+
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,
3671+
or any element with a WAI-ARIA role which allows the `aria-disabled` attribute</a>.
36503672
</p>
36513673
<p>
36523674
Authors SHOULD NOT use `aria-disabled="true"` on any element which also has a `disabled` attribute.
@@ -3665,19 +3687,22 @@ <h3 id="docconformance-attr">
36653687
</td>
36663688
<td>
36673689
<p>
3668-
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:
3690+
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
3691+
be specified, with the exception of focusable elements and the <a href="#el-body">`body`</a> element.
36693692
</p>
36703693
<p>
3671-
Authors SHOULD NOT use the `aria-hidden="true"` attribute on any element which also has a `hidden` attribute.
3672-
</p>
3673-
3674-
<!-- this will be covered as part of issue 221 -->
3675-
<!-- <p>
3676-
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.
3694+
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.
36773695
</p>
3678-
<p>
3679-
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.
3680-
</p> -->
3696+
<div class="note">
3697+
A focusable element is any element which can be focused by use of keyboard or pointer device. Focusable elements are not always elements which
3698+
can be tabbed to via a keyboard. For instance, an element with `tabindex="-1"` is focusable but is not a tabbable element.
3699+
</div>
3700+
<div class="note">
3701+
Using `aria-hidden="true"` on an element that has the `hidden` attribute is at best an unnecessary redundancy. At worst its usage can
3702+
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.
3703+
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
3704+
technology when it is found via a browser's in-page find feature and visually rendered to users.
3705+
</div>
36813706
</td>
36823707
</tr>
36833708
<tr id="att-placeholder" tabindex="-1">
@@ -3693,7 +3718,8 @@ <h3 id="docconformance-attr">
36933718
`placeholder` attribute in HTML.
36943719
</p>
36953720
<p>
3696-
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.
3721+
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,
3722+
or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute.
36973723
</p>
36983724
<p>
36993725
Authors MUST NOT use the `aria-placeholder` attribute on any element which also has a `placeholder` attribute.
@@ -3996,7 +4022,7 @@ <h2>
39964022
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.
39974023
</p>
39984024

3999-
<table id="aria-table" class="simple">
4025+
<table id="aria-table" class="data">
40004026
<caption>
40014027
Allowed descendants of ARIA roles
40024028
</caption>
@@ -4405,7 +4431,7 @@ <h2>
44054431
</tr>
44064432
<tr>
44074433
<th tabindex="-1" id="index-aria-img">
4408-
<a data-cite="wai-aria-1.2#img">`img`</a>
4434+
<a data-cite="wai-aria-1.2#img">`img` or `image`</a>
44094435
</th>
44104436
<td>
44114437
<ul>

‎makeup.css‎

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -48,26 +48,16 @@ a code {
4848
padding: 0;
4949
}
5050

51-
.simple thead {
52-
position: sticky;
53-
top: 0px;
54-
}
55-
5651
table th ul,
5752
table td ul {
5853
padding-left: .825em;
5954
}
6055

61-
.simple th {
62-
scroll-margin-top: 120px;
63-
}
64-
65-
66-
6756
/* these classes don't behave very well for inline changes.
6857
so these updates were made to make these work better in
6958
this spec. */
7059
span.addition.proposed,
60+
span.addition.correction,
7161
span.correction.proposed,
7262
span.amendment.proposed {
7363
padding: .125em .25em;

‎w3c.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
{
22
"group": [
3-
"114929"
3+
"83726"
44
],
55
"contacts": [
6-
"siusin"
6+
"daniel-montalvo"
77
],
88
"shortName": "html-aria",
99
"repo-type": "rec-track"

0 commit comments

Comments
 (0)