Skip to content

Commit 1003238

Browse files
pkrapkra
authored
Merge branch 'main' into issue1263
2 parents 022abcc + 932fc84 commit 1003238

File tree

3 files changed

+212
-13
lines changed

3 files changed

+212
-13
lines changed

‎accname/index.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -639,11 +639,11 @@ <h4>Computation steps</h4>
639639
<li id="comp_host_language_label">
640640
<span id="step2E"><!-- Don't link to this legacy numbered ID. --></span><em>Host Language Label:</em> Otherwise, if the <code>current node</code>'s native markup provides an
641641
[=attribute=] (e.g. <code>alt</code>) or [=element=] (e.g. HTML <code>label</code> or SVG <code>title</code>) that defines a text alternative, return that alternative in the form of
642-
a <code>flat string</code> as defined by the host language, unless the <code>current node</code> is exposed as presentational (<code>role="presentation"</code> or
643-
<code>role="none"</code>).
642+
a <code>flat string</code> as defined by the host language (e.g., <a href="https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation">HTML-AAM</a>), unless the
643+
<code>current node</code> is exposed as presentational (<code>role="presentation"</code> or <code>role="none"</code>).
644644
<div class="note">
645-
See <a href="https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation">HTML-AAM</a>,
646-
<a href="https://www.w3.org/TR/svg-aam-1.0/#mapping_additional_nd">SVG-AAM</a>, or other host language documentation for more information on markup that defines a text alternative.
645+
Important! The accessible name for native HTML elements may be calculated differently depending on host language. Make sure to review
646+
<a href="https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation">HTML-AAM</a> for more information.
647647
</div>
648648
<div class="note">
649649
<p>

‎html-aam/index.html

Lines changed: 203 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9270,6 +9270,204 @@ <h4 id="att-colspan">`colspan`</h4>
92709270
</tr>
92719271
</tbody>
92729272
</table>
9273+
<h4 id="att-command-popovers">`command` <span class="att-context">(in the Toggle, Show, and Hide popover states)</span></h4>
9274+
<table class="data" aria-labelledby="att-command-popovers">
9275+
<tbody>
9276+
<tr>
9277+
<th>HTML Specification</th>
9278+
<td>
9279+
<span class="el-context"> `command` </span>
9280+
</td>
9281+
</tr>
9282+
<tr>
9283+
<th>Element(s)</th>
9284+
<td>
9285+
<a data-cite="html/button.html#attr-input-command">`button`</a>
9286+
(`command` in the
9287+
<a data-cite="html/input.html#attr-button-command-toggle-popover-state" id="att-command-toggle-popover">Toggle popover state</a>
9288+
<a data-cite="html/input.html#attr-button-command-show-popover-state" id="att-command-showpopover">Show popover state</a> and
9289+
<a data-cite="html/input.html#attr-button-command-hide-popover-state" id="att-command-hidepopover">Hide popover state</a>)
9290+
</td>
9291+
</tr>
9292+
<tr>
9293+
<th>[[WAI-ARIA-1.2]]</th>
9294+
<td>
9295+
<p>
9296+
If the associated element is displayed as a popover:
9297+
<a class="core-mapping" href="#ariaExpandedTrue">`aria-expanded=true`</a>
9298+
</p>
9299+
<p>
9300+
If the associated element is hidden:
9301+
<a class="core-mapping" href="#ariaExpandedFalse">`aria-expanded=false`</a>
9302+
</p>
9303+
<p>
9304+
If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM:
9305+
<a class="core-mapping" href="#ariaExpandedUndefined">`aria-expanded=undefined`</a>
9306+
</p>
9307+
<p>If the associated element is not a valid `popover` element: no `aria-expanded` mapping.</p>
9308+
</td>
9309+
</tr>
9310+
<tr>
9311+
<th>
9312+
<a href="https://msdn.microsoft.com/en-us/library/dd373608%28v=VS.85%29.aspx">MSAA</a> + <a href="http://accessibility.linuxfoundation.org/a11yspecs/ia2/docs/html/">IAccessible2</a>
9313+
</th>
9314+
<td>
9315+
<div class="general">Use WAI-ARIA mapping</div>
9316+
<div class="objattrs"><span class="type">Object attributes:</span> `details-roles:popover`</div>
9317+
</td>
9318+
</tr>
9319+
<tr>
9320+
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
9321+
<td>
9322+
<div class="general">Use WAI-ARIA mapping</div>
9323+
</td>
9324+
</tr>
9325+
<tr>
9326+
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
9327+
<td>
9328+
<div class="general">Use WAI-ARIA mapping</div>
9329+
<div class="objattrs"><span class="type">Object attributes:</span> `details-roles:popover`</div>
9330+
</td>
9331+
</tr>
9332+
<tr>
9333+
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
9334+
<td>
9335+
<div class="general">Use WAI-ARIA mapping</div>
9336+
</td>
9337+
</tr>
9338+
<tr>
9339+
<th>Comments</th>
9340+
<td>
9341+
<p>
9342+
User Agents MUST expose an <a class="core-mapping" href="#ariaDetails">`aria-details`</a> relationship with the associated element (identified via the specified `commandfor`
9343+
attribute) <strong>except</strong> under the following conditions:
9344+
</p>
9345+
<ul>
9346+
<li>The associated popover element is the next immediate accessibility sibling to the invoking element,</li>
9347+
<li>The element is a descendant of the `popover` it is associated with.</li>
9348+
</ul>
9349+
<p class="note">
9350+
A button that represents a <a data-cite="html/forms.html#concept-submit-button">submit button</a> or is in the
9351+
<a data-cite="html/input.html#reset-button-state-(type=reset)">reset state</a> with a [=button/form owner=] cannot invoke a command.
9352+
</p>
9353+
</td>
9354+
</tr>
9355+
</tbody>
9356+
</table>
9357+
<h4 id="att-command-dialogs">`command` <span class="att-context">(in the Close and Show Modal states)</span></h4>
9358+
<table class="data" aria-labelledby="att-command-dialogs">
9359+
<tbody>
9360+
<tr>
9361+
<th>HTML Specification</th>
9362+
<td>`command`</td>
9363+
</tr>
9364+
<tr>
9365+
<th>Element(s)</th>
9366+
<td>
9367+
<a data-cite="html/button.html#attr-input-command">`button`</a>
9368+
<span class="el-context"
9369+
>(`command` in the <a data-cite="html/input.html#attr-button-command-close-state">Close state</a>) and
9370+
<a data-cite="html/input.html#attr-button-command-show-modal-state">Show Modal state</a>)</span
9371+
>
9372+
</td>
9373+
</tr>
9374+
<tr>
9375+
<th>[[WAI-ARIA-1.2]]</th>
9376+
<td>
9377+
<div class="general">A `command` attribute in the `close` and `show-modal` states provide no additional accessibility mappings to the `button` element.</div>
9378+
</td>
9379+
</tr>
9380+
<tr>
9381+
<th>
9382+
<a href="https://msdn.microsoft.com/en-us/library/dd373608%28v=VS.85%29.aspx">MSAA</a> + <a href="http://accessibility.linuxfoundation.org/a11yspecs/ia2/docs/html/">IAccessible2</a>
9383+
</th>
9384+
<td>
9385+
<div class="general">Not mapped</div>
9386+
</td>
9387+
</tr>
9388+
<tr>
9389+
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
9390+
<td>
9391+
<div class="general">Not mapped</div>
9392+
</td>
9393+
</tr>
9394+
<tr>
9395+
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
9396+
<td>
9397+
<div class="general">Not mapped</div>
9398+
</td>
9399+
</tr>
9400+
<tr>
9401+
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
9402+
<td>
9403+
<div class="general">Not mapped</div>
9404+
</td>
9405+
</tr>
9406+
<tr>
9407+
<th>Comments</th>
9408+
<td>
9409+
<p class="note">
9410+
A button that represents a <a data-cite="html/forms.html#concept-submit-button">submit button</a> or is in the
9411+
<a data-cite="html/input.html#reset-button-state-(type=reset)">reset state</a> with a [=button/form owner=] cannot invoke a command.
9412+
</p>
9413+
</td>
9414+
</tr>
9415+
</tbody>
9416+
</table>
9417+
<h4 id="att-commandfor">`commandfor`</h4>
9418+
<table aria-labelledby="att-commandfor">
9419+
<tbody>
9420+
<tr>
9421+
<th>HTML Specification</th>
9422+
<td>`commandfor`</td>
9423+
</tr>
9424+
<tr>
9425+
<th>Element(s)</th>
9426+
<td>
9427+
<a data-cite="html/button.html#attr-input-commandfor">`button`</a>
9428+
</td>
9429+
</tr>
9430+
<tr>
9431+
<th>[[WAI-ARIA-1.2]]</th>
9432+
<td>
9433+
<div class="general">See comments</div>
9434+
</td>
9435+
</tr>
9436+
<tr>
9437+
<th>
9438+
<a href="https://msdn.microsoft.com/en-us/library/dd373608%28v=VS.85%29.aspx">MSAA</a> + <a href="http://accessibility.linuxfoundation.org/a11yspecs/ia2/docs/html/">IAccessible2</a>
9439+
</th>
9440+
<td>
9441+
<div class="general">See comments</div>
9442+
</td>
9443+
</tr>
9444+
<tr>
9445+
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
9446+
<td>
9447+
<div class="general">See comments</div>
9448+
</td>
9449+
</tr>
9450+
<tr>
9451+
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
9452+
<td>
9453+
<div class="general">See comments</div>
9454+
</td>
9455+
</tr>
9456+
<tr>
9457+
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
9458+
<td>
9459+
<div class="general">See comments</div>
9460+
</td>
9461+
</tr>
9462+
<tr>
9463+
<th>Comments</th>
9464+
<td>
9465+
<p>The `commandfor` attribute identifies the associated element for the `button` element.</p>
9466+
<p>The specified `command` state will determine if a relationship mapping needs to be exposed between the `button` and its programmatically associated element.</p>
9467+
</td>
9468+
</tr>
9469+
</tbody>
9470+
</table>
92739471
<h4 id="att-content">`content`</h4>
92749472
<table class="data" aria-labelledby="att-content">
92759473
<tbody>
@@ -13441,7 +13639,7 @@ <h4 id="att-popover">`popover`</h4>
1344113639
<tr>
1344213640
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
1344313641
<td>
13444-
Not mapped
13642+
TBD
1344513643
<!-- https://bugs.webkit.org/show_bug.cgi?id=271485 -->
1344613644
</td>
1344713645
</tr>
@@ -13489,13 +13687,14 @@ <h4 id="att-popovertarget">`popovertarget`</h4>
1348913687
<a class="core-mapping" href="#ariaExpandedTrue">`aria-expanded=true`</a>
1349013688
</p>
1349113689
<p>
13492-
If the associated element is hidden, or not present in the DOM:
13690+
If the associated element is hidden:
1349313691
<a class="core-mapping" href="#ariaExpandedFalse">`aria-expanded=false`</a>
1349413692
</p>
1349513693
<p>
13496-
If the associated element is an accessibility ancestor of the element with the `popovertarget` attribute:
13694+
If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM:
1349713695
<a class="core-mapping" href="#ariaExpandedUndefined">`aria-expanded=undefined`</a>
1349813696
</p>
13697+
<p>If the associated element is not a valid `popover` element: no `aria-expanded` mapping.</p>
1349913698
</div>
1350013699
</td>
1350113700
</tr>
@@ -16597,6 +16796,7 @@ <h3>Change Log</h3>
1659716796
<section>
1659816797
<h4>Substantive changes since moving to the <a href="https://www.w3.org/WAI/ARIA/">Accessible Rich Internet Applications Working Group</a> (03-Nov-2019)</h4>
1659916798
<ul>
16799+
<li>2-April-2025: Add `command` and `commandfor` attribute mappings. See <a href="https://github.com/w3c/aria/pull/2354/">GitHub ARIA PR 2354</a>.</li>
1660016800
<li>11-July-2024: User Agents ignore `aria-hidden=true` on `body` and `html` elements. See <a href="https://github.com/w3c/html-aam/pull/516">GitHub PR 516</a>.</li>
1660116801
<li>06-June-2024: Add concept of Minimum Role. See <a href="https://github.com/w3c/html-aam/pull/454">GitHub PR 454</a>.</li>
1660216802
<li>06-June-2024: Add `popover`, `popovertarget` and `popovertargetaction` mappings. See <a href="https://github.com/w3c/html-aam/pull/481">GitHub PR 481</a>.</li>

‎index.html

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1052,7 +1052,7 @@ <h3>Information for User Agents</h3>
10521052
set <abbr title="Document Object Model">DOM</abbr> focus to the element that has the <pref>aria-activedescendant</pref> attribute.
10531053
<p class="note">
10541054
An element with an ID can be referenced when it is an <a>accessibility descendant</a> of a container element that has the <pref>aria-activedescendant</pref> attribute or by a
1055-
container element that is controlled by an element that has the <pref>aria-activedescendant</pref> attribute (e.g. see <rref>combobox</rref>). Otherwise the
1055+
container element that is controlled by an element that has the <pref>aria-activedescendant</pref> attribute (e.g., see <rref>combobox</rref>). Otherwise the
10561056
<pref>aria-activedescendant</pref> attribute reference indicates an author error.
10571057
</p>
10581058
<p class="note">The inability to set <abbr title="Document Object Model">DOM</abbr> focus to the containing element indicates an author error.</p>
@@ -2571,7 +2571,7 @@ <h2>Definition of Roles</h2>
25712571
<p>
25722572
The primary purpose of the code role is to inform assistive technologies that the content is computer code and thus might require special presentation, in particular with respect to
25732573
synthesized speech. More specifically, screen readers and other tools which provide text-to-speech presentation of content SHOULD prefer full punctuation verbosity to ensure common
2574-
symbols (e.g. "-") are spoken.
2574+
symbols (e.g., "-") are spoken.
25752575
</p>
25762576
</div>
25772577
<table class="def">
@@ -5520,7 +5520,6 @@ <h2>Definition of Roles</h2>
55205520
<td class="role-properties">
55215521
<ul>
55225522
<li><pref>aria-errormessage</pref></li>
5523-
<li><sref>aria-expanded</sref></li>
55245523
<li><sref>aria-invalid</sref></li>
55255524
<li><pref>aria-multiselectable</pref></li>
55265525
<li><pref>aria-readonly</pref></li>
@@ -14260,7 +14259,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
1426014259
<p>
1426114260
Most host languages provide an attribute that could be used to name the element (e.g., the <code>[^html-global/title^]</code> attribute in HTML), yet this could present a browser
1426214261
tooltip. In the cases where DOM content or a tooltip is undesirable, authors MAY set the accessible name of the element using <pref>aria-label</pref>, if the element does not
14263-
<a href="#prohibitedattributes">prohibit</a> use of the attribute. If the label text is available in the DOM (i.e. typically visible text content), authors SHOULD use
14262+
<a href="#prohibitedattributes">prohibit</a> use of the attribute. If the label text is available in the DOM (i.e., typically visible text content), authors SHOULD use
1426414263
<pref>aria-labelledby</pref> and SHOULD NOT use <pref>aria-label</pref>. There might be instances where the name of an element cannot be determined programmatically from the DOM, and
1426514264
there are cases where referencing DOM content is not the desired user experience. Authors MUST NOT specify <code>aria-label</code> on an element which has an explicit or implicit
1426614265
WAI-ARIA role where <code>aria-label</code> is <a href="#prohibitedattributes">prohibited</a>. As required by the
@@ -16991,15 +16990,15 @@ <h3>Disambiguation Pattern</h3>
1699116990
example, the only valid spelling for "multi-selectable" is hyphenated, so <pref>aria-multiselectable</pref> becomes <code>ariaMultiSelectable</code> with both the M and S capitalized.
1699216991
</li>
1699316992
<li>
16994-
When trusted dictionary sources list both hyphenated or non-hyphenated spellings (e.g. "multi-line" and "multiline" are both valid spellings) use the hyphenated version and apply the
16993+
When trusted dictionary sources list both hyphenated or non-hyphenated spellings (e.g., "multi-line" and "multiline" are both valid spellings) use the hyphenated version and apply the
1699516994
hyphenation rule above. For example, <pref>aria-multiline</pref> becomes <code>ariaMultiLine</code> with both the M and L capitalized.
1699616995
</li>
1699716996
<li>
1699816997
If all trusted dictionary sources list a single spelling of a compound word with no spaces or hyphens, only the first letter of the term is capitalized. For example, neither
1699916998
“place-holder” nor “place holder” are considered valid spellings of the term “placeholder,” so <pref>aria-placeholder</pref> becomes <code>ariaPlaceholder</code> with only the P
1700016999
capitalized.
1700117000
</li>
17002-
<li>There are currently no acronym-based ARIA attributes, but if future attributes include acronym usage, attempt to match existing DOM conventions (e.g. ID becomes Id).</li>
17001+
<li>There are currently no acronym-based ARIA attributes, but if future attributes include acronym usage, attempt to match existing DOM conventions (e.g., ID becomes Id).</li>
1700317002
</ul>
1700417003
</section>
1700517004
<section class="informative" id="idl_attr_exceptions">

0 commit comments

Comments
 (0)