Skip to content

[html-aam PR 510] switch attribute for checkbox inputs #2217

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.

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

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open
Changes from 5 commits
Commits
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
105 changes: 105 additions & 0 deletions html-aam/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3225,6 +3225,59 @@ <h4 id="el-input-checkbox">`input` <span class="el-context">(`type` attribute in
</tr>
</tbody>
</table>
<h4 id="el-input-checkbox-switch">`input` <span class="el-context">(`type` attribute in the Checkbox state)</span> with the <code>switch</code> attribute</h4>
<table aria-labelledby="el-input-checkbox-switch">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<a data-cite="html">`input`</a>
<span class="el-context"
>(<a data-cite="html/input.html#attr-input-type">`type`</a> attribute in the <a data-cite="html/input.html#checkbox-state-(type=checkbox)">Checkbox</a> state)</span
>
with the <a data-cite="html/input.html#attr-input-switch">`switch`</a> attribute
</td>
</tr>
<tr>
<th>[[wai-aria-1.2]]</th>
<td>
<a class="core-mapping" href="#role-map-checkbox">`switch`</a> role, with the <a class="core-mapping" href="#ariaCheckedMixed">`aria-checked`</a> state set to "true" if the element's
<a data-cite="html/form-control-infrastructure.html#concept-fe-checked">checkedness</a> is true, or "false" otherwise
</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>
Copy link
Contributor

@cookiecrook cookiecrook Aug 19, 2024

Choose a reason for hiding this comment

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

The full name is the "The macOS Accessibility Protocol" or "AX API" for short. I don't recall this even being shortened to just "AX", and in either case, the NSAccessibility link is just one subset portion. This might be the best link in general. https://developer.apple.com/documentation/accessibility Should this be changed elsewhere in HTML-AAM too? Happy to discuss offline since this may be OT for this PR.

Copy link
Member

Choose a reason for hiding this comment

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

From what I can see looking back to some of the original PRs, this spec has always referred to it as just "AX". i notice though that it is not referred to consistently across AAMs

in the accessibility api sections, HTML AAM refers to it as macOS Accessibility Protocol [AXAPI].

in other many other specs that list out the full name (often in api / important term sections), it's referred to by it's older name - The Mac OS X Accessibility Protocol [AXAPI] - if it's even directly mentioned at all.

in the mapping tables, it's handled like:
dpub AAM - Mac AX API
html aam - AX
core aam, mathml aam - AX API
graphics aam - AXAPI

i have another issue this can be addressed with, at least for html aam

Copy link
Contributor

Choose a reason for hiding this comment

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

@scottaohara Would you like me to do raise a separate issue/PR for updating this throughout html-aam?

<td>
<div class="general">Use WAI-ARIA mapping</div>
</td>
</tr>
<!-- <th><a href="#accessible-name-and-description-computation">Naming Algorithm</a></th> -->
<tr>
<th>Comments</th>
<td></td>
</tr>
</tbody>
</table>
<h4 id="el-input-color">`input` <span class="el-context">(`type` attribute in the Color state)</span></h4>
<table aria-labelledby="el-input-color">
<tbody>
Expand Down Expand Up @@ -14589,6 +14642,58 @@ <h4 id="att-step">`step`</h4>
</tr>
</tbody>
</table>
<h4 id="att-switch">`switch`</h4>
<table aria-labelledby="att-switch">
<tbody>
<tr>
<th>HTML Specification</th>
<td>`switch`</td>
</tr>
<tr>
<th>Element(s)</th>
<td><a data-cite="html/input.html#attr-input-switch">`input`</a> `type=checkbox`</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<div class="general">Not mapped</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>
The `switch` attribute modifies the semantics and behavior of the `input` element in the checkbox state. See <a href="#el-input-checkbox-switch">`input type=checkbox switch`</a> for
mapping details.
</td>
</tr>
</tbody>
</table>
<h4 id="att-style">`style`</h4>
<table aria-labelledby="att-style">
<tbody>
Expand Down
Loading