- From: Steven Faulkners via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 17 Feb 2011 12:47:10 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-api-map
In directory hutz:/tmp/cvs-serv10373
Modified Files:
overview.html
Log Message:
modified and added to the attributes tabel and accessible name calculation info
Index: overview.html
===================================================================
RCS file: /sources/public/html5/html-api-map/overview.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -d -r1.25 -r1.26
--- overview.html 14 Feb 2011 17:01:30 -0000 1.25
+++ overview.html 17 Feb 2011 12:47:01 -0000 1.26
@@ -52,7 +52,7 @@
<BODY>
<div class="head"><p><a href="http://www.w3.org/"><img width="72" height="48" src="http://www.w3.org/Icons/w3c_home" alt="W3C"></a></p><h1 class="title" id="title">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 id="w3c-editors-draft"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft, 14 February 2011</h2>
+<h2 id="w3c-editors-draft"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft, 17 February 2011</h2>
@@ -1696,8 +1696,8 @@
<td><a href="http://msdn.microsoft.com/en-us/library/accessibility.iaccessible.accname.aspx">accName</a></td>
<td><a href="http://msdn.microsoft.com/en-us/library/system.windows.automation.automationelement.automationelementinformation.name.aspx"></a></td>
<td><a href="http://msdn.microsoft.com/en-us/library/system.windows.automation.automationelement.automationelementinformation.name.aspx">Name</a></td>
- <td> </td>
- <td> </td>
+ <td><a href="http://people.gnome.org/~billh/at-spi-idl/html/namespaceAccessibility.html#a215">RELATION_LABEL_FOR</a></td>
+ <td>AXDescription</td>
<td> </td>
</tr>
<!--<tr>
@@ -1713,9 +1713,11 @@
<td>Yes</td>
<td> </td>
<td> </td>
- <td> </td>
- <td> </td>
- <td> </td>
+ <td rowspan="1" colspan="1">Object attribute autocomplete
+ <p>Expose the IA2_STATE_SUPPORTS_AUTOCOMPLETION equivalent state</p></td>
+ <td rowspan="1" colspan="1"> </td>
+ <td rowspan="1" colspan="1">Object attribute autocomplete
+ <p>Expose the <a href="http://people.gnome.org/~billh/at-spi-idl/html/namespaceAccessibility.html#a217">STATE_SUPPORTS_AUTOCOMPLETION</a> equivalent state</p></td>
<td> </td>
<td> </td>
</tr>
@@ -1764,16 +1766,29 @@
<td><a href="http://dev.w3.org/html5/spec/infrastructure.html#preferred-mime-name">Preferred MIME name</a> of an encoding* </td>
</tr>-->
<tr>
- <th> checked </th>
+ <th> checked (if present)</th>
<td><a href="http://dev.w3.org/html5/spec/interactive-elements.html#attr-command-checked">command</a>; <a href="http://dev.w3.org/html5/spec/the-input-element.html#attr-input-checked">input</a></td>
<td>Yes</td>
<td>Yes</td>
+ <td><a href="http://www.w3.org/TR/2010/WD-wai-aria-20100916/states_and_properties#aria-checked">aria-checked (state)</a>="true" (state)</td>
+ <td rowspan="1" colspan="1">Set the STATE_SYSTEM_CHECKED state</td>
+ <td rowspan="1" colspan="1">Expose object attribute checkable="true"</td>
+ <td rowspan="1" colspan="1">Expose as ToggleState property in Toggle Control Pattern</td>
+ <td rowspan="1" colspan="1">Expose object attribute checkable="true"</td>
+ <td rowspan="1" colspan="1">AXValue="1"</td>
<td> </td>
- <td> </td>
- <td> </td>
- <td> </td>
- <td> </td>
- <td> </td>
+ </tr>
+ <tr>
+ <th> checked (if absent)</th>
+ <td><a href="http://dev.w3.org/html5/spec/interactive-elements.html#attr-command-checked">command</a>; <a href="http://dev.w3.org/html5/spec/the-input-element.html#attr-input-checked">input</a></td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td><a href="http://www.w3.org/TR/2010/WD-wai-aria-20100916/states_and_properties#aria-checked">aria-checked (state)</a>="false"</td>
+ <td rowspan="1" colspan="1">Clear the STATE_SYSTEM_CHECKED state</td>
+ <td rowspan="1" colspan="1">Expose object attribute checkable="true"</td>
+ <td rowspan="1" colspan="1">Expose as ToggleState property in Toggle Control Pattern.</td>
+ <td rowspan="1" colspan="1">Expose object attribute checkable="true"</td>
+ <td rowspan="1" colspan="1">AXValue="0"</td>
<td> </td>
</tr>
<tr>
@@ -1839,12 +1854,12 @@
<td><a href="http://dev.w3.org/html5/spec/interactive-elements.html#attr-contextmenu" title="attr-contextmenu">HTML elements</a></td>
<td>No</td>
<td>Yes</td>
- <td> </td>
- <td> </td>
- <td> </td>
- <td> </td>
- <td> </td>
- <td> </td>
+ <td><a href="http://www.w3.org/WAI/PF/aria/states_and_properties#aria-haspopup">aria-haspopup</a>="true"</td>
+ <td rowspan="1" colspan="1">Expose as STATE_SYSTEM_HASPOPUP. If on a push button, change the role to ROLE_SYSTEM_BUTTONMENU.</td>
+ <td rowspan="1" colspan="1">Expose as STATE_SYSTEM_HASPOPUP. If on a push button, change the role to ROLE_SYSTEM_BUTTONMENU.</td>
+ <td rowspan="1" colspan="1">Expose state of the pop-up activities in the ExpandCollapseState property in the ExpandCollapse Control Pattern.</td>
+ <td rowspan="1" colspan="1">Object attribute haspopup="true"</td>
+ <td rowspan="1" colspan="1">Expose AXShowMenu and AXPress actions</td>
<td> </td>
</tr>
<tr>
@@ -2634,22 +2649,24 @@
<H2 id="calc">Accessible Name and Description calculation</H2>
<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 id="calc-iput"><code>Input type="text"</code> or <code>textarea</code> element</h3>
- <p>The accessible name is derived from the following sources; non-empty <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute, 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.</p>
+ <p> If the control has an <code><a href="http://www.w3.org/TR/wai-aria/states_and_properties#aria-label">aria-label</a></code> or an <code><a href="http://www.w3.org/TR/wai-aria/states_and_properties#aria-labelledby">aria-labelledby</a></code> attribute the accessible name is to be calculated using the alogorithm defined in section <a href="http://www.w3.org/TR/wai-aria/roles#namecalculation">5.2.7. Accessible Name Calculation</a> of the <a href="http://www.w3.org/TR/wai-aria/">WAI-ARIA 1.0 specification</a>. </p>
+ <p>Otherwise, the accessible name is derived from the following sources; non-empty <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#the-placeholder-attribute"><code>placeholder</code></a> attribute, 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.</p>
<p>The accessible description is derived from the following sources; 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 <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute.</p>
<ul>
- <li>If the control has a only non-empty <code>placeholder</code> attribute, use the content of the <code>placeholder</code> attribute as the control's accessible name.</li>
+ <li>If the control has <strong>only</strong> a non-empty <code>placeholder</code> attribute, use the content of the <code>placeholder</code> attribute as the control's accessible name.</li>
<li>If the control has a non-empty <code>placeholder</code> attribute and a non-empty associated <code>label</code> element, use the content of the associated <code>label</code> element as the control's accessible name. Use the content of the <code>placeholder</code> 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, 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>
- <li>If a 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>
- </ul>
- <p>Note: </p>
-<h3>Other form elements</h3>
+ <li>If the control has a non-empty <code>placeholder</code> attribute and a non-empty <code>title</code> attribute, use the content of the<code> title</code> attribute as the control's accessible name. Use the content of the <code>placeholder</code> attribute as the control's accessible description.</li>
+ <li>If the control has a non-empty <code>placeholder</code> attribute and a non-empty <code>title</code> 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 <code>placeholder</code> attribute as the control's accessible description.</li>
+ <li>If a control does not have a non-empty <code>placeholder</code> attribute or a non-empty associated <code>label</code> element or a non-empty <code>title</code> attribute, the control's accessible name is an empty string and the control's accessible description is an empty string. </li>
+ </ul>
+ <h3>Other form elements</h3>
+ <p>If the control has an <code><a href="http://www.w3.org/TR/wai-aria/states_and_properties#aria-label">aria-label</a></code> or an <code><a href="http://www.w3.org/TR/wai-aria/states_and_properties#aria-labelledby">aria-labelledby</a></code> attribute the accessible name is to be calculated using the algorithm defined in section <a href="http://www.w3.org/TR/wai-aria/roles#namecalculation">5.2.7. Accessible Name Calculation</a> of the <a href="http://www.w3.org/TR/wai-aria/">WAI-ARIA 1.0 specification</a>. </p>
+ <p>Otherwise the accessible name is derived from the following sources; 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.</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 <a href="http://dev.w3.org/html5/spec/forms.html#the-label-element"><code>label</code></a> element as the control's accessible name.</li>
- <li>If the control has a non-empty <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> 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 <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> 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 <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 <a href="http://dev.w3.org/html5/spec/semantics.html#the-title-element-0"><code>title</code></a> attribute as the control's accessible description.</li>
+ <li>If the control has neither a non-empty associated <code>label</code> element or a non-empty <code>title</code> 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 <code>label</code> element, but not a non-empty <code>title</code> 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 <code>label</code> 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 <code>label</code> element and a non-empty <code>title</code> 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>
Received on Thursday, 17 February 2011 12:47:19 UTC