Skip to content

Commit

Permalink
move command tables to attribute section
Browse files Browse the repository at this point in the history 
moves the command tables to the attributes section.  otherwise, a new table for command would have been necessary, and it would have then just pointed to these other tables.  so, moving them down here negates the need for that.

 adds the commandfor attribute mapping table
  • Loading branch information
@scottaohara
scottaohara authored Dec 10, 2024
1 parent 683691d commit eb74036
Showing 1 changed file with 197 additions and 0 deletions.
197 changes: 197 additions & 0 deletions html-aam/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9313,6 +9313,203 @@ <h4 id="att-colspan">`colspan`</h4>
</tr>
</tbody>
</table>
<h4 id="att-command-popovers">`button` <span class="el-context">(`command` attribute 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">
(<a data-cite="html/button.html#attr-input-command">`command`</a> 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>)
</span>
</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html">`button`</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">`button` <span class="el-context">(`command` attribute in the Close and Show Modal states)</span></h4>
<table aria-labelledby="att-command-dialogs">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<span class="el-context">
(<a data-cite="html/button.html#attr-input-command">`command`</a> 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-close-state">Show Modal state</a>)</span>
</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html">`button`</a>
</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">`command`</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

0 comments on commit eb74036

Please sign in to comment.