Merge pull request #85 from w3c/issue-79

section maps to region only if acc name, otherwise to div
w3c · Apr 3, 2017 · 6b3326b · 6b3326b
2 parents bc8ced5 + 5394e88
commit 6b3326b
Showing 1 changed file with 43 additions and 18 deletions.
diff --git a/html-aam/index.html b/html-aam/index.html
@@ -3039,27 +3039,52 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-section">
-                <th><a href="http://www.w3.org/TR/html51/semantics.html#the-section-element"><code>section</code></a></th>
-                <td class="aria"><p><a class="core-mapping" href="#role-map-region"><code>region</code></a> role </p>
-                <p><strong>Note:</strong>It is strongly recommended that user agents such as screen readers only convey the presence of, and provide navigation for <a href="http://www.w3.org/TR/html5/sections.html#the-section-element">section</a> elements, when the <a href="http://www.w3.org/TR/html5/sections.html#the-section-element">section</a> element has an <a class="termref">accessible name</a>.</p></td>
-                <td class="ia2"><div class="general">Use WAI-ARIA mapping</div></td>
-                <td class="uia">
-                    <div class="ctrltype">
-                        <span class="type">Control Type: </span><code>Group</code>
+                  <th><a href="http://www.w3.org/TR/html5/sections.html#the-section-element"><code>section</code></a></th>
+                  <td class="aria">
+                    <a class="core-mapping" href="#role-map-region"><code>region</code></a> role if the <a href="http://www.w3.org/TR/html5/sections.html#the-section-element"><code>section</code></a> element has an <a class="termref">accessible name</a>. Otherwise, no corresponding role.
+                  </td>
+                  <td class="ia2">
+                    <div class="general">If the <a href="http://www.w3.org/TR/html5/sections.html#the-section-element"><code>section</code></a> element has an <a class="termref">accessible name</a>, use WAI-ARIA mapping. Otherwise:</div>
+                    <div class="role">
+                      <span class="type">Roles: </span><code>ROLE_SYSTEM_GROUPING</code>; <code>IA2_ROLE_SECTION</code>
                     </div>
-                    <div class="ctrltype"><span class="type">Localized Control Type:</span> <code>"section"</code> (all lower-case)
+                    <div class="ifaces">
+                      <span class="type">Interfaces: </span><code>IAccessibleText2</code>; <code>IAccessibleHypertext2</code>;
                     </div>
-                    <div class="ctrltype">
-                        <span class="type">Landmark Type:</span> <code>Custom</code>
+                  </td>
+                  <td class="uia">
+                    <div class="general">If the <a href="http://www.w3.org/TR/html5/sections.html#the-section-element"><code>section</code></a> element has an <a class="termref">accessible name</a>:</div>
+                    <div class="ctrltype"><span class="type">Control Type: </span><code>Group</code></div>
+                    <div class="ctrltype"><span class="type">Localized Control Type:</span> <code>"section"</code> (all lower-case)</div>
+                    <div class="ctrltype"><span class="type">Landmark Type:</span> <code>Custom</code></div>
+                    <div class="ctrltype"><span class="type">Localized Landmark Type:</span> <code>"region"</code> (all lower-case)</div>
+                    <div class="general">Otherwise:</div>
+                    <div class="ctrltype"><span class="type">Control Type: </span><code>Group</code></div>
+                  </td>
+                  <td class="atk">
+                    <div class="general">If the <a href="http://www.w3.org/TR/html5/sections.html#the-section-element"><code>section</code></a> element has an <a class="termref">accessible name</a>, use WAI-ARIA mapping. Otherwise:</div>
+                    <div class="role">
+                      <span class="type">Role: </span>
+                      <code>ATK_ROLE_SECTION</code>
+                     </div>
+                     <div class="ifaces">
+                      <span class="type">Interfaces: </span><code>AtkText</code>; <code>AtkHypertext</code>
                     </div>
-                    <div class="ctrltype">
-                    <span class="type">Localized Landmark Type:</span> <code>"region"</code> (all lower-case)
-              </div>
-                </td>
-                <td class="atk"><div class="general">Use WAI-ARIA mapping</div></td>
-                <td class="ax"><div class="general">Use WAI-ARIA mapping</div></td>
-                <td class="comments"></td>
-            </tr>
+                  </td>
+                  <td class="ax">
+                    <div class="general">If the <a href="http://www.w3.org/TR/html5/sections.html#the-section-element"><code>section</code></a> element has an <a class="termref">accessible name</a>, use WAI-ARIA mapping. Otherwise:</div>
+                    <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>
+                  </td>
+                  <td class="comments"></td>
+              </tr>
             <tr tabindex="-1" id="el-select-listbox">
                 <th>
                   <a href="http://www.w3.org/TR/html51/semantics.html#the-select-element"><code>select</code></a>