Skip to content
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

Clarify UIA and AX mappings for audio/video and sub-dom controls #110

Merged
merged 3 commits into from
Nov 23, 2017
Merged

Clarify UIA and AX mappings for audio/video and sub-dom controls #110

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ab5855f
Clarify UIA and AX mappings for audio/video and sub-dom controls
jasonkiss Feb 8, 2017
ae8ba12
Merge branch 'gh-pages' into issue-80
jasonkiss Nov 23, 2017
518350f
include note in change log
jasonkiss Nov 23, 2017
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
111 changes: 57 additions & 54 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -432,33 +432,33 @@ <h3>HTML Element Role Mappings</h3>
</div>
</td>
<td class="uia">
<div class="ctrltype">
<span class="type">Control Type: </span><code>Group</code>
</div>
<div class="ctrltype"><span class="type">Localized Control Type:</span> <code>"audio"</code></div>
<div class="general">If the <a href="https://www.w3.org/TR/html/semantics-embedded-content.html#element-attrdef-mediaelements-controls"><code>controls</code></a> attribute is present, each control is a child in the UIA tree, and mapped as <a class="core-mapping" href="#role-map-button"><code>button</code></a>, <a class="core-mapping" href="#role-map-slider"><code>slider</code></a>, etc. as appropriate for the type of control.</div>
<div class="general">Loading and error text objects, along with any control not currently displayed, MAY be present in the UIA and marked as hidden or off-screen.</div>
</td>
<td class="atk">
<div class="role">
<span class="type">Role: </span>
<code>ATK_ROLE_AUDIO</code>
</div>
</td>
<td class="ax">
<div class="ctrltype">
<span class="type">Control Type: </span><code>Group</code>
</div>
<div class="ctrltype"><span class="type">Localized Control Type:</span> <code>"audio"</code></div>
<div class="general"><b>Note:</b> If the <a href="https://www.w3.org/TR/html/semantics.html#attr-media-controls"><code>controls</code></a> attribute is present, UI controls (e.g. play, volume) are exposed as children of the <a href="https://www.w3.org/TR/html/semantics-embedded-content.html#the-audio-element"><code>audio</code></a> element in the <a class="termref">accessibility tree</a>, and mapped as appropriate for the type of control (e.g. <a class="core-mapping" href="#role-map-button"><code>button</code></a> or <a class="core-mapping" href="#role-map-slider"><code>slider</code></a>).</div>
<div class="general">Text objects associated with loading or error messages, and any UI control not currently displayed, MAY be present in the <a class="termref">accessibility tree</a> and marked as hidden or off-screen.</div>
</td>
<td class="atk">
<div class="role">
<span class="type">AXRole: </span><code>AXGroup</code>
</div>
<div class="subrole">
<span class="type">AXSubrole: </span><code>(nil)</code>
</div>
<div class="roledesc">
<span class="type">AXRoleDescription: </span><code>"group"</code>
<span class="type">Role: </span>
<code>ATK_ROLE_AUDIO</code>
</div>
<div class="general"><b>Note:</b> UI controls within the audio element exposed as <code>AXToolbar</code>.</div>
</td>
<td class="comments"></td>
</tr>
</td>
<td class="ax">
<div class="role">
<span class="type">AXRole: </span><code>AXGroup</code>
</div>
<div class="subrole">
<span class="type">AXSubrole: </span><code>AXAudio</code>
</div>
<div class="roledesc">
<span class="type">AXRoleDescription: </span><code>"audio playback"</code>
</div>
<div class="general"><b>Note:</b> If the <a href="https://www.w3.org/TR/html/semantics.html#attr-media-controls"><code>controls</code></a> attribute is present, UI controls (e.g. play, volume) are exposed as descendants of an <a class="termref">accessible object</a> with a role of <a class="core-mapping" href="#role-map-toolbar"><code>toolbar</code></a>, and mapped as appropriate for the type of control (e.g. <a class="core-mapping" href="#role-map-button"><code>button</code></a> or <a class="core-mapping" href="#role-map-slider"><code>slider</code></a>).</div>
</td>
<td class="comments"></td>
</tr>
<tr tabindex="-1" id="el-b">
<th><a href="https://www.w3.org/TR/html/textlevel-semantics.html#the-b-element"><code>b</code></a></th>
<td class="aria">No corresponding role</td>
Expand Down Expand Up @@ -3490,39 +3490,41 @@ <h3>HTML Element Role Mappings</h3>
<td class="comments"></td>
</tr>
<tr tabindex="-1" id="el-video">
<th><a href="https://www.w3.org/TR/html/semantics-embedded-content.html#the-video-element"><code>video</code></a></th>
<td class="aria">No corresponding role</td>
<td class="ia2">
<div class="role">
<span class="type">Role: </span><code>ROLE_SYSTEM_GROUPING</code>
</div>
</td>
<td class="uia">
<th><a href="http://www.w3.org/TR/html/semantics.html#the-video-element"><code>video</code></a></th>
<td class="aria">No corresponding role</td>
<td class="ia2">
<div class="role">
<span class="type">Role: </span><code>ROLE_SYSTEM_GROUPING</code>
</div>
</td>
<td class="uia">
<div class="ctrltype">
<span class="type">Control Type: </span><code>Group</code>
<span class="type">Control Type: </span><code>Group</code>
</div>
<div class="general">If the <a href="https://www.w3.org/TR/html/semantics-embedded-content.html#element-attrdef-mediaelements-controls"><code>controls</code></a> attribute is present, each control is a child in the UIA tree, and mapped as button, slider, etc. as appropriate for the type of control.</div>
<div class="general">Loading and error text objects, along with any control not currently displayed, MAY be present in the UIA and marked as hidden or off-screen.</div>
</td>
<td class="atk">
<div class="ctrltype"><span class="type">Localized Control Type:</span> <code>"group"</code></div>
<div class="general"><b>Note:</b> If the <a href="https://www.w3.org/TR/html/semantics.html#attr-media-controls"><code>controls</code></a> attribute is present, UI controls (e.g. play, volume) are exposed as children of the <a href="https://www.w3.org/TR/html/semantics-embedded-content.html#the-video-element"><code>video</code></a> element in the <a class="termref">accessibility tree</a>, and mapped as appropriate for the type of control (e.g. <a class="core-mapping" href="#role-map-button"><code>button</code></a> or <a class="core-mapping" href="#role-map-slider"><code>slider</code></a>).</div>
<div class="general">Text objects associated with loading or error messages, and any UI control not currently displayed, MAY be present in the <a class="termref">accessibility tree</a> and marked as hidden or off-screen.</div>
</td>
<td class="atk">
<div class="role">
<span class="type">Role: </span>
<code>ATK_ROLE_VIDEO</code>
</div>
</td>
<td class="ax">
<div class="role">
<span class="type">Role: </span>
<code>ATK_ROLE_VIDEO</code>
<span class="type">AXRole: </span><code>AXGroup</code>
</div>
</td>
<td class="ax">
<div class="role">
<span class="type">AXRole: </span><code>AXGroup</code>
</div>
<div class="subrole">
<span class="type">AXSubrole: </span><code>(nil)</code>
</div>
<div class="roledesc">
<span class="type">AXRoleDescription: </span><code>"group"</code>
</div>
<div class="general"><b>Note:</b> UI controls within the video element exposed as <code>AXToolbar</code>.</div>
</td>
<td class="comments"></td>
<div class="subrole">
<span class="type">AXSubrole: </span><code>AXVideo</code>
</div>
<div class="roledesc">
<span class="type">AXRoleDescription: </span><code>"video playback"</code>
</div>
<div class="general"><b>Note:</b> If the <a href="https://www.w3.org/TR/html/semantics.html#attr-media-controls"><code>controls</code></a> attribute is present, UI controls (e.g. play, volume) are exposed as descendants of an <a class="termref">accessible object</a> with a role of <a class="core-mapping" href="#role-map-toolbar"><code>toolbar</code></a>, and mapped as appropriate for the type of control (e.g. <a class="core-mapping" href="#role-map-button"><code>button</code></a> or <a class="core-mapping" href="#role-map-slider"><code>slider</code></a>).</div>
</td>
<td class="comments"></td>
<td class="comments"></td>
</tr>
<tr tabindex="-1" id="el-wbr">
<th><a href="https://www.w3.org/TR/html/textlevel-semantics.html#the-wbr-element"><code>wbr</code></a></th>
Expand Down Expand Up @@ -5986,6 +5988,7 @@ <h3>Change Log</h3>
<section>
<h4>Substantive changes since moving entirely to the Web Platform Working Group (01-Oct-2016)</h4>
<ul>
<li>24-Nov-2017: Updated mappings for the <code>audio</code> and <code>video</code> elements. See <a href="https://github.com/w3c/html-aam/issues/80">GitHub issue #80</a>.</li>
<li>09-Aug-2017: Updated mappings for the <code>type</code> attribute on the <code>ol</code> element. See <a href="https://github.com/w3c/html-aam/issues/91">GitHub issue #91</a>.</li>
<li>25-July-2017: Updated UIA mappings for multiple elements and attributes. See <a href="https://github.com/w3c/html-aam/issues/95">GitHub issue #95</a> and <a href="https://github.com/w3c/html-aam/pull/101">GitHub pull request #101</a>.</li>
<li>02-June-2017: Updated AXAPI mappings for <code>title</code> attribute on <code>abbr</code> element, and <code>abbr</code> attribute on <code>th</code> element. See <a href="https://github.com/w3c/html-aam/issues/16">GitHub issue #16</a>.</li>
Expand Down