Skip to content

Accessibility mapping of <a> element #2844

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

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

Accessibility mapping of <a> element #2844

Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8bfe418
Mapping of mathml a element
tannal Jul 13, 2026
0465769
Change MSAA and UIA to TBD
tannal Jul 14, 2026
8035363
Introduce WAI-ARIA mapping for MathML anchor element
tannal Jul 23, 2026
4227f19
Reword the description
tannal Jul 23, 2026
98f1835
Reword again
tannal Jul 24, 2026
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
37 changes: 37 additions & 0 deletions mathml-aam/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -160,6 +160,43 @@ <h3>Exposing features that do not directly map to accessibility <abbr title="app

<section>
<h3>MathML Element Mappings</h3>
<h4 id="el-a">`a`</h4>
<table class="data" aria-labelledby="el-a">
<tbody>
<tr>
<th>MathML Specification</th>
<td>
<a data-cite="MathML3/chapter5.html#mixing.elements.a">`a`</a>
</td>
</tr>
<tr>
<th>[[wai-aria-1.1]]</th>
<td>No corresponding role</td>

@spectranaut spectranaut Jul 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I'm a little worried that this is so similar to the core-aam definition of an a element -- other than the AXSubrole.

For example: The "tag" object attribute is actually always exposed, for all elements, that should be made more clear in the Core-AAM, and the linux mappings in the Core-AAM mention HyperlinkImpl, which is not mentioned here.

I think it might be better to say that there is a corresponding role, and that you should follow it, but that there is an AXSubrole override. So basically, for ATK write "Use the WAI-ARIA mappings" like here https://w3c.github.io/html-aam/#el-a, but for AX AXPI write "Use the WAI-ARIA mappings, but override subrole with..."

@tannal tannal Jul 23, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done.

</tr>
<tr>
<th>MSAA + IAccessible2</th>
<td>TBD</td>
</tr>
<tr>
<th><abbr title="User Interface Automation">UIA</abbr></th>
<td>TBD</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr></th>
<td>
<span class="role">Role: <code>ATK_ROLE_LINK</code></span><br />
<span class="objattr">Object Attribute: <code>tag:a</code></span>
</td>
</tr>
<tr>
<th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
<td>
<span class="role">AXRole: <code>AXLink</code></span><br />
<span class="subrole">AXSubrole: <code>AXMathRow</code></span>
</td>
</tr>
</tbody>
</table>
<h4 id="el-annotation">`annotation`</h4>
<table class="data" aria-labelledby="el-annotation">
<tbody>
Expand Down