The MathML Accessibility API Mappings (MathML-AAM) specification defines how user agents map Mathematical Markup Language (MathML) [MathML3] to platform accessibility APIs. It extends the Core Accessibility API Mappings (CORE-AAM) specification [CORE-AAM-1.2].
This specification is intended for user agent developers responsible for MathML accessibility in their product. The goal of this specification is to maximize the accessibility of MathML content by ensuring each assistive technology receives MathML content with the roles, states, and properties it expects.
At the present time, this specification contains mappings for the subset of MathML contained in the MathML Core specification [MathML-Core]. The reason why is that this subset contains the elements and attributes from MathML which are exposed to assistive technologies via platform accessibility APIs.
The MathML-AAM is part of the WAI-ARIA suite described in the WAI-ARIA Overview.
Status of This DocumentThis section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C standards and drafts index.
This document is a work in progress.
To provide feedback, please create or comment on an issue in the W3C MathML Accessibility API Mappings GitHub repository. If this is not feasible, send email to public-aria@w3.org.
This document was published by the Accessible Rich Internet Applications Working Group as an Editor's Draft.
Publication as an Editor's Draft does not imply endorsement by W3C and its Members.
This is a draft document and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to cite this document as other than a work in progress.
This document was produced by a group operating under the W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent that the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
This document is governed by the 18 August 2025 W3C Process Document.
Table of Contentsannotation
annotation-xml
maction
math
merror
mfrac
mi
mmultiscripts
mn
mo
mover
mpadded
mphantom
mprescripts
mroot
mrow
ms
mspace
msqrt
mstyle
msub
msubsup
msup
mtable
mtd
mtext
mtr
munder
munderover
none
semantics
As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.
The key word MUST in this document is to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, it appears in all capitals, as shown here.
Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.
Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such recommendations in order to conform to this specification.
There are currently no deprecated requirements.
User agents MUST conform to General rules for exposing WAI-ARIA semantics in [CORE-AAM-1.2].
User agents MUST conform to Conflicts between native markup semantics and WAI-ARIA in [CORE-AAM-1.2].
User agents MUST conform to Exposing attributes that do not directly map to accessibility API properties in [CORE-AAM-1.2].
MathML Specificationannotation
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_STATIC
tag:annotation
AX API AXRole: NSAccessibilityGroupRole
TBD
MathML Specification annotation-xml
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:annotation-xml
AX API AXRole: NSAccessibilityGroupRole
TBD
MathML Specification maction
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:maction
AX API AXRole: NSAccessibilityGroupRole
TBD
MathML Specification math
[wai-aria-1.1] math
role MSAA + IAccessible2
Use WAI-ARIA mapping
UIAUse WAI-ARIA mapping
ATKUse WAI-ARIA mapping
AX APIUse WAI-ARIA mapping
MathML Specificationmerror
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:merror
AX API AXRole: NSAccessibilityGroupRole
AXMathRow
MathML Specification mfrac
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_MATH_FRACTION
tag:mfrac
AX API AXRole: NSAccessibilityGroupRole
AXMathFraction
AXMathFractionNumerator
pointing to the first in-flow childAXMathFractionDenominator
pointing to the second in-flow child MathML Specification mi
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_STATIC
tag:mi
AX API AXRole: NSAccessibilityGroupRole
AXMathIdentifier
MathML Specification mmultiscripts
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:mmultiscripts
AX API AXRole: NSAccessibilityGroupRole
AXMathMultiscript
AXAttributes:
AXMathPostscripts
is an array of dictionaries of AXMathSubscript
and AXMathSupscript
pointing to postsubscript and postsupscript elements , i.e. N and N + 1 in-flow children starting from the second in-flow child and preceeding mprescripts
element if any;AXMathPrescripts
is an array of dictionaries of AXMathSubscript
and AXMathSupscript
pointing to presubscript and presupscript elements, i.e. N and N + 1 in-flow children starting after mprescripts
element if any or from index 1.mn
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_STATIC
tag:ms
AX API AXRole: NSAccessibilityGroupRole
AXMathNumber
MathML Specification mo
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_STATIC
tag:mo
AX API AXRole: NSAccessibilityGroupRole
AXMathOperator
MathML Specification mover
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:mover
AX API AXRole: NSAccessibilityGroupRole
AXMathUnderOver
AXMathBase
pointing to the first in-flow child AXMathOver
pointing to the second in-flow child MathML Specification mpadded
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:mpadded
AX API AXRole: NSAccessibilityGroupRole
TBD
MathML Specification mphantom
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:mphantom
AX API AXRole: NSAccessibilityGroupRole
AXMathRow
MathML Specification mprescripts
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:mprescripts
AX API Not mapped MathML Specification mroot
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_MATH_ROOT
tag:mroot
AX API AXRole: NSAccessibilityGroupRole
AXMathRoot
AXMathRootRadicand
is an array containing the first in-flow child as its unique element,AXMathRootIndex
pointing to the second in-flow child MathML Specification mrow
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:mrow
AX API AXRole: NSAccessibilityGroupRole
AXMathRow
MathML Specification ms
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_STATIC
tag:ms
AX API AXRole: NSAccessibilityGroupRole
nil
MathML Specification mspace
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Not mapped AX API Not mapped MathML Specification msqrt
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_MATH_ROOT
tag:mroot
AX API AXRole: NSAccessibilityGroupRole
AXMathSquareRoot
AXMathRootRadicand
is an array containing the in-flow children MathML Specification mstyle
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:mstyle
AX API AXRole: NSAccessibilityGroupRole
AXMathRow
MathML Specification msub
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:msub
AX API AXRole: NSAccessibilityGroupRole
AXMathSubscriptSuperscript
AXMathBase
pointing to the first in-flow childAXMathSubscript
pointing to the second in-flow child MathML Specification msubsup
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:msubsup
AX API AXRole: NSAccessibilityGroupRole
AXMathSubscriptSuperscript
AXMathBase
pointing to the first in-flow child AXMathSubscript
pointing to the second in-flow childAXMathSuperscript
pointing to the third in-flow child MathML Specification msup
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:msup
AX API AXRole: NSAccessibilityGroupRole
AXMathSubscriptSuperscript
AXMathBase
pointing to the first in-flow childAXMathSuperscript
pointing to the second in-flow child MathML Specification mtable
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_TABLE
tag:mtable
AtkTable
AX API AXRole: NSAccessibilityGroupRole
AXMathTable
MathML Specification mtd
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_TABLE_CELL
tag:mtd
AtkTableCell
AX API AXRole: NSAccessibilityGroupRole
AXMathTableCell
MathML Specification mtext
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_STATIC
tag:mtext
AX API AXRole: NSAccessibilityGroupRole
AXMathText
MathML Specification mtr
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_TABLE_ROW
tag:mtr
AX API AXRole: NSAccessibilityGroupRole
AXMathTableRow
MathML Specification munder
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:munder
AX API AXRole: NSAccessibilityGroupRole
AXMathUnderOver
AXMathBase
pointing to the first in-flow childAXMathUnder
pointing to the second in-flow child MathML Specification munderover
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:munderover
AX API AXRole: NSAccessibilityGroupRole
AXMathUnderOver
AXMathBase
pointing to the first in-flow childAXMathUnder
pointing to the second in-flow childAXMathOver
pointing to the third in-flow child MathML Specification none
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:none
AX API AXRole: TBD
TBD
MathML Specification semantics
[wai-aria-1.1] No corresponding role MSAA + IAccessible2 TBD UIA TBD ATK Role: ATK_ROLE_SECTION
tag:semantics
AX API AXRole: NSAccessibilityGroupRole
TBD
This section is non-normative.
The following people contributed to the development of this document.
This publication has been funded in part with U.S. Federal funds from the Department of Education, National Institute on Disability, Independent Living, and Rehabilitation Research (NIDILRR), initially under contract number ED-OSE-10-C-0067, then under contract number HHSP23301500054C, and now under HHS75P00120P00168. The content of this publication does not necessarily reflect the views or policies of the U.S. Department of Education, nor does mention of trade names, commercial products, or organizations imply endorsement by the U.S. Government.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.5