<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>16586</bug_id>
          
          <creation_ts>2012-03-30 19:17:53 +0000</creation_ts>
          <short_desc>Accessibility API Role Mapping Matrix missing math and svg elements</short_desc>
          <delta_ts>2012-05-14 05:54:01 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>HTML a11y APIs (editor: Steve Faulkner, Cynthia Shelly)</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>a11y</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="nsoiffer2">neils</reporter>
          <assigned_to name="Jason Kiss">jason</assigned_to>
          <cc>bhawkeslewis</cc>
    
    <cc>hans.hillen</cc>
    
    <cc>jason</cc>
    
    <cc>mike</cc>
    
    <cc>public-html-admin</cc>
    
    <cc>public-html-wg-issue-tracking</cc>
          
          <qa_contact name="HTML a11y API spec bugbot">sideshowbarker+html-a11y-api</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>66293</commentid>
    <comment_count>0</comment_count>
    <who name="nsoiffer2">neils</who>
    <bug_when>2012-03-30 19:17:53 +0000</bug_when>
    <thetext>This is a comment/bug report on [1].

Section 3 (HTML element to Accessibility API Role Mapping Matrix) contains a mapping of elements to accessibility roles.  I see that both math and svg are missing from that &quot;matrix&quot;.  I don&apos;t know enough to suggest mappings for svg, but for math, the following entries are appropriate:

HTML 4:  no
HTML 5:  yes
WAI-ARIA: math role
MSAA:  ROLE_SYSTEM_EQUATION

I don&apos;t have direct knowledge of the other values, but most are found in section 5.4.1 in [2].  The children of the math element (eg, mrow, mfrac) should NOT be exposed to AT.

Note that [3] mentions that for legacy content that use images for math, using role=math is appropriate.  The alt should be TeX or MathML and the aria-describedby should be used to describe the math.  I think this should be mentioned as part of the description of the img element mapping (section 5.6?)


Neil Soiffer
[speaking for myself -- I have not run this by the MathML WG]


[1] http://www.w3.org/TR/2012/WD-html-aapi-20120329
[2] http://www.w3.org/WAI/PF/aria-implementation
[3] http://www.w3.org/TR/wai-aria/roles#math</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66302</commentid>
    <comment_count>1</comment_count>
    <who name="Benjamin Hawkes-Lewis">bhawkeslewis</who>
    <bug_when>2012-03-31 09:14:15 +0000</bug_when>
    <thetext>(In reply to comment #0)
&gt; This is a comment/bug report on [1].
&gt; 
&gt; Section 3 (HTML element to Accessibility API Role Mapping Matrix) contains a
&gt; mapping of elements to accessibility roles.  I see that both math and svg are
&gt; missing from that &quot;matrix&quot;.  I don&apos;t know enough to suggest mappings for svg,
&gt; but for math, the following entries are appropriate:
&gt; 
&gt; HTML 4:  no
&gt; HTML 5:  yes
&gt; WAI-ARIA: math role
&gt; MSAA:  ROLE_SYSTEM_EQUATION
&gt; 
&gt; I don&apos;t have direct knowledge of the other values, but most are found in
&gt; section 5.4.1 in [2].  The children of the math element (eg, mrow, mfrac)
&gt; should NOT be exposed to AT.

Say I were extending an accessibility client to render mathematical notations to speech or nemeth. If the accessibility tree does not include a representation of the mathematical content, how would that transformation work? Is your recommendation that user agents should hand over access to the DOM using a specific interface that is *not* part of the the platform accessibility APIs? If so, can we spell out what that specific interface could be?

What&apos;s the progress on representing mathematical content directly in all platform accessibility APIs? Is anyone working on that or is that dead in the water?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66324</commentid>
    <comment_count>2</comment_count>
    <who name="nsoiffer2">neils</who>
    <bug_when>2012-04-02 05:53:21 +0000</bug_when>
    <thetext>(In reply to comment #1)

&gt; &gt; I don&apos;t have direct knowledge of the other values, but most are found in
&gt; &gt; section 5.4.1 in [2].  The children of the math element (eg, mrow, mfrac)
&gt; &gt; should NOT be exposed to AT.
&gt; 
&gt; Say I were extending an accessibility client to render mathematical notations
&gt; to speech or nemeth. If the accessibility tree does not include a
&gt; representation of the mathematical content, how would that transformation work?
&gt; Is your recommendation that user agents should hand over access to the DOM
&gt; using a specific interface that is *not* part of the the platform accessibility
&gt; APIs? If so, can we spell out what that specific interface could be?

When I wrote my comment about the children not being exposed, I was indeed thinking about the model where AT says to a third party app -- &quot;you figure this out&quot;.  In that case, you don&apos;t want AT plowing into the children.  However, since the AT has a pointer to the accessibility tree, the obvious thing is to hand over a pointer to that tree and the helper app either can get a pointer back to the full DOM or the accessibility tree needs to expose the children of the math element.  I&apos;m willing to concede that my suggestion of the children not being part of the accessibility tree is potentially bad and withdraw it.


&gt; 
&gt; What&apos;s the progress on representing mathematical content directly in all
&gt; platform accessibility APIs? Is anyone working on that or is that dead in the
&gt; water?

My company has for years made math accessible in IE.  We are working on a plan for math accessibility (mathml-&gt;speech text, sync highlighting, navigation, and math braille codes) that will work in all browsers.  I discussed some options with several AT vendors at CSUN 2012 (give us a pointer to the node and the &quot;type&quot; of the tree/DOM), or give us the MathML string, or ...) and they were generally favorable pending seeing the details.  I&apos;m hopeful we&apos;ll have something working with at least one vendor by mid-summer as part of a grant we are jointly working on.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67635</commentid>
    <comment_count>3</comment_count>
    <who name="Jason Kiss">jason</who>
    <bug_when>2012-05-13 04:44:40 +0000</bug_when>
    <thetext>math and svg have been added to [1].

All but UIA mapping provided for math. Mappings for svg still required.

Calling this fixed as elements now present in mapping matrix. Establishing final mappings and details is ongoing.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67640</commentid>
    <comment_count>4</comment_count>
    <who name="Jason Kiss">jason</who>
    <bug_when>2012-05-14 05:54:01 +0000</bug_when>
    <thetext>That is, math and svg have been added to http://dvcs.w3.org/hg/html-api-map/raw-file/tip/Overview.html</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>