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 all 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
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 @@ -9272,6 +9272,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> relationship 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>
Comment on lines +9387 to +9405
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think TBD may be better than not mapped in these cases? "Not mapped" always seems purposeful rather than, "TBD," aka "let's determine how to map this before publishing the next snapshot."

</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` state will determine if a relationship 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