- From: Steven Faulkners via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 03 Feb 2011 12:38:37 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-api-map
In directory hutz:/tmp/cvs-serv22343
Modified Files:
overview.html
Log Message:
added details under accessible name/description calculation
Index: overview.html
===================================================================
RCS file: /sources/public/html5/html-api-map/overview.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- overview.html 1 Feb 2011 12:55:53 -0000 1.19
+++ overview.html 3 Feb 2011 12:38:35 -0000 1.20
@@ -52,7 +52,7 @@
<BODY>
<H1>HTML to Platform Accessibility APIs Implementation Guide</H1>
<h2 id="subhead">A user agent developer's guide to understanding and implementing accessibility support in HTML</h2>
- <H2>Editor's Draft, 1 February 2011</H2>
+ <H2>Editor's Draft, 3 February 2011</H2>
<H3>Editors:</H3>
<P>
<A href="mailto:sfaulkner@paciellogroup.com">Steve Faulkner</A>, The Paciello Group.</P>
@@ -969,7 +969,7 @@
<TD>?</TD>
</TR>
<TR height="149">
- <td><a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element </td>
+ <td><a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a>element </td>
<TD>yes</TD>
<TD>yes</TD>
<td>none</td>
@@ -2741,14 +2741,22 @@
</table>
<H2> </H2>
<H2>Accessible Name and Description calculation</H2>
- <H2 class="note">to do</H2>
- <h3>Form elements that can have a placeholder attribute</h3>
- <p>If the control has a non-empty <code>placeholder</code> attibute but does not have a non-empty associated <code>label</code> element or a non-empty<code> title</code> attribute, use the content of the <code>placeholder</code> attribute as the controls accessible name.</p>
- <p>If the control has a non-empty <code>placeholder</code> attibute and a non-empty associated <code>label</code> element, but not a <code>title</code> attribute, use the content of the associated <code>label</code> element as the controls accessible name. Use the content of the placeholder attribute as the controls accessible description.</p>
- <p>If the control has a non-empty <code>placeholder</code> attribute and a non-empty title attribute, but not an associated non-empty<code> label</code> element, use the content of the<code> title</code> attribute as the controls accessible name. Use the content of the <code>placeholder</code> attribute as the controls accessible description.</p>
- <p><span class="note">to do</span></p>
+ <p>The terms <a href="http://www.w3.org/WAI/PF/aria-implementation/#def_accessible_name">accessible name</a> and accessible description are properties provided in all accessibility APIs. The name of the properties may differ across APIs but they serve the same function: as a container for a short (name) or longer (description) string of text. </p>
+ <h3><code>Input type="text"</code> or <code>textarea</code> element</h3>
+ <ul>
+ <li>If the control does not have a non-empty <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute or a non-empty associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element or a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute, the control's accessible name is an empty string and the control's accessible description is an empty string.</li>
+ <li>If the control has a non-empty <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attibute, but does not have a non-empty associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element or a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute, use the content of the <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute as the control's accessible name.</li>
+ <li>If the control has a non-empty <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attibute and a non-empty associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element, but not a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute, use the content of the associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element as the control's accessible name. Use the content of the placeholder attribute as the control's accessible description.</li>
+ <li>If the control has a non-empty <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute and a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute, but not an associated non-empty<code> label</code> element, use the content of the<code> title</code> attribute as the control's accessible name. Use the content of the <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute as the control's accessible description.</li>
+ <li>If the control has a non-empty <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute and a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute and associated non-empty <code>label</code> element, use the content of the <code>label</code> element as the control's accessible name. Use the content of the <code>title</code> attribute concatenated with the content of the <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute as the control's accessible description.</li>
+ </ul>
<h3>Other form elements</h3>
- <p><span class="note">to do</span></p>
+ <ul>
+ <li>If the control has neither a non-empty associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element or a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute the control's accessible name is an empty string and the control's accessible description is an empty string.</li>
+ <li>If the control has a non-empty associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element, but not a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute, use the content of the associated <code>label</code>element as the control's accessible name.</li>
+ <li>If the control has a non-empty<code> title</code> attribute, but not a non-empty associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element, use the content of the <code>title</code> attribute as the control's accessible name.</li>
+ <li>If the control has a non-empty associated <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element and a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute, use the content of the associated <code>label</code> element as the control's accessible name. Use the content of the <code>title</code> attribute as the control's accessible description.</li>
+ </ul>
<h3>Figure and figcaption elements </h3>
<p><span class="note">to do</span></p>
<p>img element</p>
@@ -2756,20 +2764,4 @@
<h2>Accessible Description calculation</h2>
<p><span class="note">to do</span></p>
<H2> </H2>
- <H2>To Do:</H2>
- <P class="style2">In addition to the comments column, here are some general to do
- items. </P>
- <UL>
- <LI>Add additional attribute mappings</LI>
- <LI>Add additional element mappings </LI>
- <LI>Describe individual elements that "define a command"
- and how their mappings change based on context (when they do and
- don't define a command)</LI>
- <LI>double check all 'none' mappings. Are they
- true? Is it really none, or text, or inherits?</LI>
- <LI>change msaa to ROLE_SYSTEM_FOO</LI>
- <LI>use composites for MSAA for menuitemcheckbox and menuitemradio?</LI>
- <LI>either expand name, state, value etc for other APIs, or combine
- for MSAA</LI>
- <LI>Look at how to augment imperfect mappings with UIA patterns.</LI>
- <LI>double check harmonization with ARIA UAI Guide</LI></UL></BODY></HTML>
\ No newline at end of file
+ <H2> </H2></BODY></HTML>
\ No newline at end of file
Received on Thursday, 3 February 2011 12:38:39 UTC