RE: The design for role=math isn't understandable from WAI ARIA 1.0 spec text


Superficially, the implementation guide seems wrong.  However, the Math WG people who are most involved with math accessibility and ARIA are going through your message and docs you reference and will make a more definitive response shortly.

Thanks for drawing our attention to the problem.


Robert Miner
W3C Math WG co-chair
Design Science, Inc.
140 Pine Avenue, 4th Floor
Long Beach, California 90802
Main:   (562) 432-2920
Direct: (651) 223-2883
Fax:    (651) 292-0014

> -----Original Message-----
> From: [] On
> Behalf Of Henri Sivonen
> Sent: Thursday, February 03, 2011 7:07 AM
> To:
> Cc:
> Subject: The design for role=math isn't understandable from WAI ARIA
> 1.0 spec text
> This comment applies to

> Desciption of concern:
> The CR-wai-aria text about how role=math works seems to be very
> confused. It says "Content with the role math is intended to be marked
> up in an accessible format such as MathML [MATHML], or with another
> type of textual representation such as TeX or LaTeX, which can be
> readily converted to an accessible format by assistive technologies."
> This may imply to the reader that the content that gets exposed to AT
> is computing from the MathML or LaTeX content.
> However, reading the examples in CR-wai-aria together with
> from the
> latest ED of the Implementation Guide, it turns out that the reading
> the above to imply that the MathML or LaTeX content gets "converted to
> an accessible format by assistive techologies" is totally wrong. The
> Implementation Guide says: 'The following elements are not exposed via
> the accessibility API and user agents SHOULD NOT include them in the
> accessible tree:'--'children of the following objects, which have the
> characteristic "Children Presentational: True":' followed by a list
> that includes the role "math".
> Now with this information about implementation, let's take a look at a
> MathML example from CR-wai-aria:
> <div role="math" aria-label="6 divided by 4 equals 1.5">
>   <math xmlns="">
>     <mfrac>
>       <mn>6</mn>
>       <mn>4</mn>
>     </mfrac>
>     <mo>=</mo>
>     <mn>1.5</mn>
>   </math>
> </div>
> The div has role=math, so per the Implementation Guide, its children
> SHOULD NOT be included in the accessible tree. Thus, what's left to
> expose is
> <div role="math" aria-label="6 divided by 4 equals 1.5"></div>
> Thus, the MathML subtree doesn't get exposed to AT. Instead, the string
> "6 divided by 4 equals 1.5" gets exposed.
> This isn't *at all* clear from CR-wai-aria. Furthermore, it shifts the
> burden of generating text from MathML to the content author instead of
> having the client software compute a text-to-speech or Braille-friendly
> textual representation from MathML.
> Proposed fix:
> Remove the role "math" from the language. Expect client software to
> generate text-to-speech/Braille-friendly text from MathML, since MathML
> is an "accessible format". This is the better fix, because it requires
> MathML to text functionality to reside in relatively few client
> implementations instead of residing in relatively many content creation
> tools.
> Alternative proposed fix:
> If the WAI doesn't believe that MathML to text support on the client is
> forthcoming, please don't call MathML an "accessible format" and make
> it clear in WAI ARIA 1.0 that role=math means the value of the aria-
> label attribute gets exposed to AT and the children get ignored for AT
> exposure purposes.
> P.S. In any case, please strike the sentence "This role provides a hook
> whereby a plug-in mechanism can provide multi-modal access to compliant
> MathML, as well as enabling support for MathML in "mainstream" user
> agents." It's wrong to imply that Firefox, which supports MathML, isn't
> mainstream. The sentence doesn't explain why a plug-in mechanism
> couldn't provide multi-modal access to MathML simply by identifying
> MathML without the help of a role attribute.
> --
> Henri Sivonen

Received on Thursday, 3 February 2011 19:10:07 UTC