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

Add command & commandfor attribute related mappings #2354

Merged
merged 32 commits into from
Apr 2, 2025
Merged

Add command & commandfor attribute related mappings #2354

Changes from 11 commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
de58e32
Add command & commandfor attribute related mappings
keithamus Oct 11, 2024
a0fb231
chore: prettier
keithamus Oct 11, 2024
503a46f
Update html-aam/index.html
scottaohara Oct 17, 2024
0b1053c
expand to 1 table per command attribute state
keithamus Oct 17, 2024
f94c4c3
fix typo
keithamus Oct 18, 2024
bf0440a
rephrase MUST NOTs to MUST EXCEPT
keithamus Oct 18, 2024
733c39e
correct note around submit buttons and command attributes
keithamus Dec 4, 2024
683691d
Consolidate button command popover states
scottaohara Dec 10, 2024
eb74036
move command tables to attribute section
scottaohara Dec 10, 2024
86d1225
fix headings
scottaohara Dec 10, 2024
793899b
fix up attr titling, remove prior role mapping tables
scottaohara Dec 10, 2024
ea14151
Update html-aam/index.html
scottaohara Dec 10, 2024
2483768
Update html-aam/index.html
scottaohara Dec 16, 2024
b8abc0f
Merge branch 'main' into add-commandfor-attribute-related-mappings
keithamus Feb 4, 2025
54e66b5
Merge branch 'main' into add-commandfor-attribute-related-mappings
keithamus Feb 27, 2025
a969e1c
Apply suggestions from code review
keithamus Mar 7, 2025
43f0357
chore: prettier
keithamus Mar 7, 2025
b5529ea
Merge branch 'main' into add-commandfor-attribute-related-mappings
keithamus Mar 7, 2025
d379824
update mappings per feedback from luke/james
scottaohara Mar 7, 2025
410a008
chore: prettier
scottaohara Mar 7, 2025
cbe8916
Add `class=data` to tables
keithamus Mar 10, 2025
8360823
Merge branch 'main' into add-commandfor-attribute-related-mappings
keithamus Mar 10, 2025
5cf0bfe
chore: prettier
keithamus Mar 10, 2025
c3de955
Merge branch 'main' into add-commandfor-attribute-related-mappings
scottaohara Mar 13, 2025
127839a
chore: prettier
scottaohara Mar 13, 2025
881654a
Update accname/index.html
scottaohara Mar 14, 2025
45aa088
Update html-aam/index.html
scottaohara Apr 2, 2025
1ce030a
Merge branch 'main' into add-commandfor-attribute-related-mappings
scottaohara Apr 2, 2025
3d747b2
chore: prettier
scottaohara Apr 2, 2025
3392a88
Update accname/index.html
scottaohara Apr 2, 2025
ab3ef14
Update accname/index.html
scottaohara Apr 2, 2025
956a062
update changelog
scottaohara Apr 2, 2025
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
198 changes: 198 additions & 0 deletions html-aam/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9184,6 +9184,204 @@ <h4 id="att-colspan">`colspan`</h4>
</tr>
</tbody>
</table>
<h4 id="att-command-popovers">`command` <span class="att-context">(in the Toggle, Show, and Hide popover states)</span></h4>
<table aria-labelledby="att-command-popovers">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<span class="el-context">
`command`
</span>
</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html/button.html#attr-input-command">`button`</a>
(`command` in the
<a data-cite="html/input.html#attr-button-command-toggle-popover-state" id="att-command-toggle-popover">Toggle popover state</a>
<a data-cite="html/input.html#attr-button-command-show-popover-state" id="att-command-showpopover">Show popover state</a> and
<a data-cite="html/input.html#attr-button-command-hide-popover-state" id="att-command-hidepopover">Hide popover state</a>)
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<p>
If the associated element is displayed as a popover:
<a class="core-mapping" href="#ariaExpandedTrue">`aria-expanded=true`</a>
</p>
<p>
If the the associated element is hidden, or not present in the DOM:
<a class="core-mapping" href="#ariaExpandedFalse">`aria-expanded=false`</a>
</p>
<p>
If the the associated element is an accessibility ancestor of the element with the `command` attribute:
<a class="core-mapping" href="#ariaExpandedUndefined">`aria-expanded=undefined`</a>
</p>
</td>
</tr>
<tr>
<th>
<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>
</th>
<td>
<div class="general">Use WAI-ARIA mapping</div>
<div class="objattrs"><span class="type">Object attributes:</span> `details-roles:popover`</div>
</td>
</tr>
<tr>
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
<td>
<div class="general">Use WAI-ARIA mapping</div>
</td>
</tr>
<tr>
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
<td>
<div class="general">Use WAI-ARIA mapping</div>
<div class="objattrs"><span class="type">Object attributes:</span> `details-roles:popover`</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
<div class="general">Use WAI-ARIA mapping</div>
</td>
</tr>
<tr>
<th>Comments</th>
<td>
<p>
User Agents MUST expose an <a class="core-mapping" href="#ariaDetails">`aria-details`</a> relation with the associated element (identified via the specified `commandfor` attribute) <strong>except</strong> under the following conditions:
</p>
<ul>
<li>The associated popover element is the next immediate accessibility sibling to the invoking element,</li>
<li>The element is a descendant of the `popover` it is associated with.</li>
</ul>
<p class="note">A button that represents a <a data-cite="html/forms.html#concept-submit-button">submit button</a> with a [=button/form owner=] cannot invoke a command.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="att-command-dialogs">`command` <span class="att-context">(in the Close and Show Modal states)</span></h4>
<table aria-labelledby="att-command-dialogs">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
`command`
</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html/button.html#attr-input-command">`button`</a>
<span class="el-context">(`command` in the
<a data-cite="html/input.html#attr-button-command-close-state">Close state</a>) and
<a data-cite="html/input.html#attr-button-command-show-modal-state">Show Modal state</a>)</span>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<div class="general">
A `command` attribute in the `close` and `show-modal` states provide no additional accessibility mappings to the `button` element.
</div>
</td>
</tr>
<tr>
<th>
<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>
</th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th>Comments</th>
<td>
<p class="note">A button that represents a <a data-cite="html/forms.html#concept-submit-button">submit button</a> with a [=button/form owner=] cannot invoke a command.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="att-commandfor">`commandfor`</h4>
<table aria-labelledby="att-commandfor">
<tbody>
<tr>
<th>HTML Specification</th>
<td>`commandfor`</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html/button.html#attr-input-commandfor">`button`</a>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<div class="general">See comments</div>
</td>
</tr>
<tr>
<th>
<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>
</th>
<td>
<div class="general">See comments</div>
</td>
</tr>
<tr>
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
<td>
<div class="general">See comments</div>
</td>
</tr>
<tr>
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
<td>
<div class="general">See comments</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
<div class="general">See comments</div>
</td>
</tr>
<tr>
<th>Comments</th>
<td>
<p>The `commandfor` attribute identifies the associated element for the `button` element.</p>
<p>
The specified `command` will indicate if a mapping needs to be exposed between the `button` and
its programmatically associated element.
</p>
</td>
</tr>
</tbody>
</table>
<h4 id="att-content">`content`</h4>
<table aria-labelledby="att-content">
<tbody>
Expand Down
Loading