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

Open
wants to merge 15 commits into
base: main
Choose a base branch
from
Open

Add command & commandfor attribute related mappings #2354

Changes from 6 commits
Commits
Show all changes
15 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
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
322 changes: 322 additions & 0 deletions html-aam/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1257,6 +1257,328 @@ <h4 id="el-button">`button`</h4>
</tr>
</tbody>
</table>
<h4 id="el-button-command-togglepopover">`button` <span class="el-context">(`command` attribute in the Toggle popover state)</span></h4>
<table aria-labelledby="el-button-command-togglepopover">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<a data-cite="html">`button`</a>
<span class="el-context">(<a data-cite="html/button.html#attr-input-command">`command`</a> attribute in the <a data-cite="html/input.html#attr-button-command-toggle-popover-state">Toggle popover</a> state)</span>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<a class="core-mapping" href="#role-map-button">`button`</a> role.
<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 <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>
<!-- accessibility sibling will be defined in the ARIA specification -->
</ul>
<p class="note">A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="el-button-command-showpopover">`button` <span class="el-context">(`command` attribute in the Show popover state)</span></h4>
<table aria-labelledby="el-button-command-showpopover">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<a data-cite="html">`button`</a>
<span class="el-context">(<a data-cite="html/button.html#attr-input-command">`command`</a> attribute in the <a data-cite="html/input.html#attr-button-command-show-popover-state">Show popover</a> state)</span>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<a class="core-mapping" href="#role-map-button">`button`</a> role.
<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 <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>
</ul>
<p class="note">A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="el-button-command-hidepopover">`button` <span class="el-context">(`command` attribute in the Hide popover state)</span></h4>
<table aria-labelledby="el-button-command-hidepopover">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<a data-cite="html">`button`</a>
<span class="el-context">(<a data-cite="html/button.html#attr-input-command">`command`</a> attribute in the <a data-cite="html/input.html#attr-button-command-hide-popover-state">Hide popover</a> state)</span>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<a class="core-mapping" href="#role-map-button">`button`</a> role.
<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 <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>
</ul>
<p class="note">A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="el-button-command-close">`button` <span class="el-context">(`command` attribute in the Close state)</span></h4>
<table aria-labelledby="el-button-command-close">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<a data-cite="html">`button`</a>
<span class="el-context">(<a data-cite="html/button.html#attr-input-command">`command`</a> attribute in the <a data-cite="html/input.html#attr-button-command-close-state">Close</a> state)</span>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<a class="core-mapping" href="#role-map-button">`button`</a> role.
<p>
If the associated element is an open dialog:
<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>
</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>
</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 class="note">A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="el-button-command-showmodal">`button` <span class="el-context">(`command` attribute in the Show modal state)</span></h4>
<table aria-labelledby="el-button-command-showmodal">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<a data-cite="html">`button`</a>
<span class="el-context">(<a data-cite="html/button.html#attr-input-command">`command`</a> attribute in the <a data-cite="html/input.html#attr-button-command-show-modal-state">Show modal</a> state)</span>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td><a class="core-mapping" href="#role-map-button">`button`</a> role.</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>
</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>
</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 class="note">A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="el-canvas">`canvas`</h4>
<table aria-labelledby="el-canvas">
<tbody>
Expand Down
Loading