From 43440da2522d28bb8229fe214018fc622f886b3d Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Mon, 22 Jul 2019 20:56:51 -0400
Subject: [PATCH 01/12] if mapped initial commit

* adds bullet to element role mappings
* adds TODO add if mapped for ia2/uia
* adds if mapped conditional for ATK mappings
* minor cleanups
---
 index.html | 303 +++++++++++++++++++++++++++++++++++------------------
 1 file changed, 200 insertions(+), 103 deletions(-)

diff --git a/index.html b/index.html
index d08512c1..6f6cea65 100644
--- a/index.html
+++ b/index.html
@@ -200,23 +200,43 @@ <h5>Use of the DOM by Some Assistive Technologies</h5>
       <h3>HTML Element Role Mappings</h3>
     	<p><strong>Notes:</strong></p>
     	<ul>
-    		<li>HTML elements with default WAI-ARIA role semantics MUST be mapped to platform <a class="termref">accessibility APIs</a> according to those WAI-ARIA roles' mappings as defined in the [[core-aam-1.2]] specification.</li>
-        <li>A '?' in a cell indicates the data has yet to be provided.</li>
-    		<li>"Not mapped" (Not Applicable) means the element does not need to be exposed via an <a class="termref">accessibility API</a>. This is usually because the element is not displayed as part of the user interface.</li>
-        <li>Where applicable, how an element participates in the computation of its own or another element's <a class="termref">accessible name</a> and/or <a class="termref">accessible description</a> is described in the <a href="#accessible-name-and-description-computation">Accessible Name and Description Computation</a> section below.</li>
-        <li>Where an element is indicated as having &quot;No corresponding [WAI-ARIA] role&quot;, user agents MUST NOT expose the <a class="core-mapping" href="#ariaRoleDescription"><code>aria-roledescription</code></a> property value in the <a class="termref">accessibility tree</a> unless the element has an explicit, conforming `role` attribute value.</li>
-        <li><strong>IAccessible2:</strong>
+    		<li>
+          HTML elements with default WAI-ARIA role semantics MUST be mapped to platform <a class="termref">accessibility APIs</a> according to those WAI-ARIA roles' mappings as defined in the [[core-aam-1.2]] specification.
+        </li>
+        <li>
+          A '?' in a cell indicates the data has yet to be provided.
+        </li>
+    		<li>
+          "Not mapped" means the element does not need to be exposed via an <a class="termref">accessibility API</a>. This is usually due to the element not being displayed as part of the user interface.
+        </li>
+        <li>
+          "If mapped" means the element is conditionally exposed in the accessibility tree. User agents MUST map the element if it is interactive or has semantic meaning. User agents MAY also include this element in the accessibility tree for implementation-specific reasons.
+        </li>
+        <li>
+          Where applicable, how an element participates in the computation of its own or another element's <a class="termref">accessible name</a> and/or <a class="termref">accessible description</a> is described in the <a href="#accessible-name-and-description-computation">Accessible Name and Description Computation</a> section below.
+        </li>
+        <li>
+          Where an element is indicated as having &quot;No corresponding [WAI-ARIA] role&quot;, user agents MUST NOT expose the <a class="core-mapping" href="#ariaRoleDescription"><code>aria-roledescription</code></a> property value in the <a class="termref">accessibility tree</a> unless the element has an explicit, conforming `role` attribute value.
+        </li>
+        <li>
+          <strong>IAccessible2:</strong>
           <ul>
             <li>All elements with accessible objects should implement the IAccessible, IAccessible2 and IAccessible2_2 interfaces.</li>
           </ul>
         </li>
-        <li><strong>UIA:</strong>
+        <li>
+          <strong>UIA:</strong>
           <ul>
-            <li>When a <a href="https://www.w3.org/TR/html/sec-forms.html#labelable-element">labelable element</a> is referenced by a `label` element's `for` attribute, or a descendant of a `label` element, the labelable element's UIA `LabeledBy` property points to the UIA element for the `label` element.</li>
-            <li>Elements mapped to the `Text` Control Type are not generally represented as <a class="termref" data-lt="accessible object">accessible objects</a> in the <a class="termref">accessibility tree</a>, but are just part of the `Text` Control Pattern implemented for the whole HTML document. However, if they have any `aria-` attributes or an explicit `tabindex` specified, elements mapped to the `Text` Control Type will be represented as <a class="termref" data-lt="accessible object">accessible objects</a> in the <a class="termref">accessibility tree</a>.</li>
+            <li>
+              When a <a href="https://www.w3.org/TR/html/sec-forms.html#labelable-element">labelable element</a> is referenced by a `label` element's `for` attribute, or a descendant of a `label` element, the labelable element's UIA `LabeledBy` property points to the UIA element for the `label` element.
+            </li>
+            <li>
+              Elements mapped to the `Text` Control Type are not generally represented as <a class="termref" data-lt="accessible object">accessible objects</a> in the <a class="termref">accessibility tree</a>, but are just part of the `Text` Control Pattern implemented for the whole HTML document. However, if they have any `aria-` attributes or an explicit `tabindex` specified, elements mapped to the `Text` Control Type will be represented as <a class="termref" data-lt="accessible object">accessible objects</a> in the <a class="termref">accessibility tree</a>.
+            </li>
           </ul>
         </li>
-    		<li><strong>AXAPI:</strong>
+    		<li>
+          <strong>AXAPI:</strong>
           <ul>
             <li>User agents should return a user-presentable, localized string value for the Mac Accessibility AXRoleDescription.</li>
           </ul>
@@ -283,12 +303,10 @@ <h3>HTML Element Role Mappings</h3>
               </td>
               <td class="atk">
                 <div class="role">
-                  <span class="type">Role:</span>
-                  `ATK_ROLE_STATIC`
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="ifaces">
-                  <span class="type">Interfaces:</span>
-                  `AtkText`; `AtkHypertext`
+                  <span class="type">Interfaces:</span> `AtkText`; `AtkHypertext`
                 </div>
               </td>
               <td class="ax">
@@ -502,18 +520,23 @@ <h3>HTML Element Role Mappings</h3>
               </th>
               <td class="aria">No corresponding role</td>
               <td class="ia2">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Exposed as "font-weight" text attribute on the text container. The value depends on the platform.
                 </div>
               </td>
               <td class="uia">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Exposed by the `FontWeight` attribute of the `TextRange` Control Pattern implemented on a parent accessible object.
                 </div>
               </td>
               <td class="atk">
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                </div>
                 <div class="general">
-                  No accessible object. Exposed as "font-weight" text attribute on the text container. The value depends on the platform.
+                  Otherwise no accessible object. Exposed as "font-weight" text attribute on the text container. The value depends on the platform.
                 </div>
               </td>
               <td class="ax">
@@ -546,6 +569,7 @@ <h3>HTML Element Role Mappings</h3>
               </th>
               <td class="aria">No corresponding role</td>
               <td class="ia2">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. May affect on "writing-mode" text attribute on its text container.
                 </div>
@@ -556,8 +580,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                </div>
                 <div class="general">
-                  No accessible object. May affect on "writing-mode" text attribute on its text container.
+                  Otherwise no accessible object. May affect on "writing-mode" text attribute on its text container.
                 </div>
               </td>
               <td class="ax"></td>
@@ -582,8 +609,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                </div>
                 <div class="general">
-                  No accessible object. Exposed as "writing-mode" text attribute on its text container.
+                  Otherwise no accessible object. Exposed as "writing-mode" text attribute on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -804,18 +834,23 @@ <h3>HTML Element Role Mappings</h3>
               </th>
               <td class="aria">No corresponding role</td>
               <td class="ia2">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="uia">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Styles used are exposed by UIA text attributes of the `TextRange` Control Pattern implemented on a parent accessible object.
                 </div>
               </td>
               <td class="atk">
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                </div>
                 <div class="general">
-                  No accessible object. Styles used are mapped into text attributes on its text container.
+                  Otherwise no accessible object. Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -837,18 +872,23 @@ <h3>HTML Element Role Mappings</h3>
               </th>
               <td class="aria">No corresponding role</td>
               <td class="ia2">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="uia">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Styles used are exposed by UIA text attributes of the `TextRange` Control Pattern implemented on a parent accessible object.
                 </div>
               </td>
               <td class="atk">
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                </div>
                 <div class="general">
-                  No accessible object. Styles used are mapped into text attributes on its text container.
+                  Otherwise no accessible object. Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -1168,18 +1208,23 @@ <h3>HTML Element Role Mappings</h3>
               </th>
               <td class="aria">No corresponding role</td>
               <td class="ia2">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="uia">
+                <!-- TODO add if mapped -->
                 <div class="general">
                   No accessible object. Styles used are exposed by UIA text attributes of the `TextRange` Control Pattern implemented on a parent accessible object.
                 </div>
               </td>
               <td class="atk">
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                </div>
                 <div class="general">
-                  No accessible object. Styles used are mapped into text attributes on its text container.
+                  Otherwise no accessible object. Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -1575,18 +1620,23 @@ <h3>HTML Element Role Mappings</h3>
               </th>
               <td class="aria">No corresponding role</td>
               <td class="ia2">
+                <!-- TODO add if mapped -->
                 <div class="general">No accessible object.</div>
                 <div class="properties">
                   <span class="type">Text attributes: </span><code>font-style:italic</code> on the text container
                 </div>
               </td>
               <td class="uia">
+                <!-- TODO add if mapped -->
                 <div class="general">No accessible object. Exposed by the <code>IsItalic</code> attribute of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                 </div>
               </td>
               <td class="atk">
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                </div>
                 <div class="general">
-                  No accessible object. Exposed as "font-style:italic" text attribute on its text container.
+                  Otherwise no accessible object. Exposed as "font-style:italic" text attribute on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -2259,20 +2309,23 @@ <h3>HTML Element Role Mappings</h3>
                 <th><a data-cite="HTML">`kbd`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object.</div>
                   <div class="properties">
                     <span class="type">Text attributes: </span><code>font-family:monospace</code> on the text container
                   </div>
                 </td>
                 <td class="uia">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Styles used are exposed by UIA text attribute identifiers of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="role">
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  </div>
                   <div class="general">
-                    No accessible object. Mapped into
-                    "font-family:monospace" text attribute on its text
-                    container.
+                    Otherwise no accessible object. Mapped into "font-family:monospace" text attribute on its text container.
                   </div>
                 </td>
                 <td class="ax">
@@ -2778,8 +2831,7 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="atk">
                   <div class="role">
-                    <span class="type">Role: </span>
-                    <code>ATK_ROLE_SECTION</code>
+                    <span class="type">Role:</span> `ATK_ROLE_SECTION`
                   </div>
                   <div class="general">
                     Styles used are mapped to text attributes on the accessible object.
@@ -2974,30 +3026,36 @@ <h3>HTML Element Role Mappings</h3>
                 <th><a data-cite="HTML">`s`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object.</div>
                   <div class="properties">
-                        <span class="type">Text attributes: </span><code>text-line-through-style:solid</code> on the text container
+                    <span class="type">Text attributes: </span><code>text-line-through-style:solid</code> on the text container
                   </div>
                 </td>
                 <td class="uia">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Styles used are exposed by UIA text attribute identifiers of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                   </div>
                 </td>
                 <td class="atk">
-                  <div class="general">No accessible object. Exposed as
+                  <div class="role">
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  </div>
+                  <div class="general">
+                    Otherwise no accessible object. Exposed as
                     "text-line-through-style:solid" text attribute on the text container.
                   </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="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>
@@ -3005,18 +3063,22 @@ <h3>HTML Element Role Mappings</h3>
                 <th><a data-cite="HTML">`samp`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
+                  <!-- TODO add if mapped -->
                   <div class="general">
                     No accessible object. Styles are mapped into text attributes on its text container.
                   </div>
                 </td>
                 <td class="uia">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Styles used are exposed by UIA text attribute identifiers of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="role">
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  </div>
                   <div class="general">
-                    No accessible object. Styles are mapped into
-                    text attributes on its text container.
+                    Otherwise no accessible object. Styles are mapped into text attributes on its text container.
                   </div>
                 </td>
                 <td class="ax">
@@ -3122,31 +3184,35 @@ <h3>HTML Element Role Mappings</h3>
                 <th><a data-cite="HTML">`small`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
+                  <!-- add iff mapped -->
                   <div class="general">No accessible object.</div>
                   <div class="properties">
                     <span class="type">Text attributes: </span><code>font-size</code> on the text container
                   </div>
                 </td>
                 <td class="uia">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Exposed by <code>FontSize</code> attribute of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="role">
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  </div>
                   <div class="general">
-                    No accessible object. Exposed as "font-size"
-                    text attribute on the text container.
+                    Otherwise no accessible object. Exposed as "font-size" text attribute on the text container.
                   </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="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>
@@ -3160,44 +3226,55 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-span">
-                <th><a data-cite="HTML">`span`</a></th>
-                <td class="aria">No corresponding role</td>
-                <td class="ia2"><div class="general">Not mapped</div></td>
-                <td class="uia">
-                    <div class="ctrltype">
-                        <span class="type">Control Type: </span><code>Group</code>
-                    </div>
-                </td>
-                <td class="atk"><div class="general">Not mapped</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>
-                </td>
-                <td class="comments"></td>
+              <th>
+                <a data-cite="HTML">`span`</a>
+              </th>
+              <td class="aria">No corresponding role</td>
+              <td class="ia2">
+                <!-- TODO add if mapped -->
+                <div class="general">Not mapped</div>
+              </td>
+              <td class="uia">
+                <div class="ctrltype">
+                  <span class="type">Control Type:</span> `Group`
+                </div>
+              </td>
+              <td class="atk">
+                <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+              </td>
+              <td class="ax">
+                <div class="role">
+                  <span class="type">AXRole:</span> `AXGroup`
+                </div>
+                <div class="subrole">
+                  <span class="type">AXSubrole:</span> `(nil)`
+                </div>
+                <div class="roledesc">
+                  <span class="type">AXRoleDescription:</span> `"group"`
+                </div>
+              </td>
+              <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-strong">
                 <th><a data-cite="HTML">`strong`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
+                  <!-- TODO add if mapped -->
                   <div class="general">
                     No accessible object. Styles used are mapped into text attributes on its text container.
                   </div>
                 </td>
                 <td class="uia">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Styles used are exposed by UIA text attribute identifiers of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="role">
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  </div>
                   <div class="general">
-                    No accessible object. Styles used are mapped
-                    into text attributes on its text container.
+                    No accessible object. Styles used are mapped into text attributes on its text container.
                   </div>
                 </td>
                 <td class="ax">
@@ -3239,7 +3316,7 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="uia">
                   <div class="ctrltype">
-                      <span class="type">Control Type: </span><code>Text</code>
+                    <span class="type">Control Type: </span><code>Text</code>
                   </div>
                   <div class="general">Styles used are exposed by <code>IsSubscript</code> attribute of the <code>TextRange</code> Control Pattern implemented on the accessible object.
                   </div>
@@ -3317,7 +3394,7 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="uia">
                   <div class="ctrltype">
-                      <span class="type">Control Type: </span><code>Text</code>
+                    <span class="type">Control Type: </span><code>Text</code>
                   </div>
                   <div class="general">Styles used are exposed by <code>IsSuperscript</code> attribute of the <code>TextRange</code> Control Pattern implemented on the accessible object.
                   </div>
@@ -3538,16 +3615,21 @@ <h3>HTML Element Role Mappings</h3>
                 <th><a data-cite="HTML">`u`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Exposed as "text-underline-style:solid" text attribute on its text container.
                   </div>
                 </td>
                 <td class="uia">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Exposed by <code>UnderlineStyle</code> attribute of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                   </div>
                 </td>
                 <td class="atk">
-                  <div class="general">No accessible object. Exposed as
-                    "text-underline-style:solid" text attribute on its text container.
+                  <div class="role">
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  </div>
+                  <div class="general">
+                    Otherwise no accessible object. Exposed as "text-underline-style:solid" text attribute on its text container.
                   </div>
                 </td>
                 <td class="ax">?</td>
@@ -3566,25 +3648,32 @@ <h3>HTML Element Role Mappings</h3>
                 <th><a data-cite="HTML">`var`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Styles used are mapped to text attributes on its text container.</div>
                 </td>
                 <td class="uia">
+                  <!-- TODO add if mapped -->
                   <div class="general">No accessible object. Styles used are exposed by UIA text attribute identifiers of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
                   </div>
                 </td>
                 <td class="atk">
-                  <div class="general">No accessible object. Styles used are mapped to text attributes on its text container.</div>
+                  <div class="role">
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  </div>
+                  <div class="general">
+                    Otherwise no accessible object. Styles used are mapped to text attributes on its text container.
+                  </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="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>
@@ -3598,7 +3687,7 @@ <h3>HTML Element Role Mappings</h3>
               </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="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>
@@ -3629,25 +3718,25 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
                   <div class="general">
-                    If a line break is added, expose it with <code>IAccessibleText</code> on the text container
+                    If a line break is added, expose it with <code>IAccessibleText</code> on the text container.
                   </div>
                 </td>
                 <td class="uia"><div class="general">Not mapped</div></td>
                 <td class="atk">
                   <div class="general">
-                    A line break if added is exposed via Text interface on its text container
+                    A line break, if added, is exposed via Text interface on its text container.
                   </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="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>
@@ -3659,10 +3748,18 @@ <h3>HTML Element Role Mappings</h3>
       <h3>HTML Attribute State and Property Mappings</h3>
       <p><strong>Notes:</strong> </p>
       <ul>
-        <li>HTML attributes with default WAI-ARIA state and property semantics MUST be mapped to platform <a class="termref">accessibility APIs</a> according to those WAI-ARIA state and property mappings as defined in the [[core-aam-1.2]] specification.</li>
-        <li>A '?' in a cell indicates the data has yet to be provided.</li>
-        <li>"Not mapped" (Not Applicable) means the attribute does not need to be exposed via an <a class="termref">accessibility API</a>. This is usually because the attribute is not displayed as part of the user interface.</li>
-        <li>All elements having an accessible object in IAccessible2 mapping are supposed to implement IAccessible, IAccessible2 and IAccessible2_2 interfaces.</li>
+        <li>
+          HTML attributes with default WAI-ARIA state and property semantics MUST be mapped to platform <a class="termref">accessibility APIs</a> according to those WAI-ARIA state and property mappings as defined in the [[core-aam-1.2]] specification.
+        </li>
+        <li>
+          A '?' in a cell indicates the data has yet to be provided.
+        </li>
+        <li>
+          "Not mapped" (Not Applicable) means the attribute does not need to be exposed via an <a class="termref">accessibility API</a>. This is usually because the attribute is not displayed as part of the user interface.
+        </li>
+        <li>
+          All elements having an accessible object in IAccessible2 mapping are supposed to implement IAccessible, IAccessible2 and IAccessible2_2 interfaces.
+        </li>
       </ul>
       <div class="table-container">
         <table class="map-table attributes" id="attribute-mapping-table">

From 9437bce799d012e4bb97c8458d1a5b9f65d2d877 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Wed, 24 Jul 2019 10:41:17 -0400
Subject: [PATCH 02/12] update url of link ref

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 6f6cea65..6b6e136a 100644
--- a/index.html
+++ b/index.html
@@ -228,7 +228,7 @@ <h3>HTML Element Role Mappings</h3>
           <strong>UIA:</strong>
           <ul>
             <li>
-              When a <a href="https://www.w3.org/TR/html/sec-forms.html#labelable-element">labelable element</a> is referenced by a `label` element's `for` attribute, or a descendant of a `label` element, the labelable element's UIA `LabeledBy` property points to the UIA element for the `label` element.
+              When a <a data-cite="html/#category-label">labelable element</a> is referenced by a `label` element's `for` attribute, or a descendant of a `label` element, the labelable element's UIA `LabeledBy` property points to the UIA element for the `label` element.
             </li>
             <li>
               Elements mapped to the `Text` Control Type are not generally represented as <a class="termref" data-lt="accessible object">accessible objects</a> in the <a class="termref">accessibility tree</a>, but are just part of the `Text` Control Pattern implemented for the whole HTML document. However, if they have any `aria-` attributes or an explicit `tabindex` specified, elements mapped to the `Text` Control Type will be represented as <a class="termref" data-lt="accessible object">accessible objects</a> in the <a class="termref">accessibility tree</a>.

From b690ac741588d59c5884630a8b1acc0f1ce1261d Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Fri, 26 Jul 2019 21:58:19 -0400
Subject: [PATCH 03/12] cleanup

---
 index.html | 122 ++++++++++++++++++++++++++++-------------------------
 1 file changed, 64 insertions(+), 58 deletions(-)

diff --git a/index.html b/index.html
index 6b6e136a..0e2b090b 100644
--- a/index.html
+++ b/index.html
@@ -536,7 +536,8 @@ <h3>HTML Element Role Mappings</h3>
                   <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
                 </div>
                 <div class="general">
-                  Otherwise no accessible object. Exposed as "font-weight" text attribute on the text container. The value depends on the platform.
+                  Otherwise no accessible object.
+                  Exposed as "font-weight" text attribute on the text container. The value depends on the platform.
                 </div>
               </td>
               <td class="ax">
@@ -584,7 +585,8 @@ <h3>HTML Element Role Mappings</h3>
                   <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
                 </div>
                 <div class="general">
-                  Otherwise no accessible object. May affect on "writing-mode" text attribute on its text container.
+                  Otherwise no accessible object.
+                  May affect on "writing-mode" text attribute on its text container.
                 </div>
               </td>
               <td class="ax"></td>
@@ -613,7 +615,8 @@ <h3>HTML Element Role Mappings</h3>
                   <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
                 </div>
                 <div class="general">
-                  Otherwise no accessible object. Exposed as "writing-mode" text attribute on its text container.
+                  Otherwise no accessible object.
+                  Exposed as "writing-mode" text attribute on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -749,12 +752,12 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="uia">
-                    <div class="ctrltype">
-                        <span class="type">Control Type: </span><code>Image</code>
-                    </div>
-                    <div class="general">
-                        Descendants of the <code>canvas</code> element are mapped separately.
-                    </div>
+                  <div class="ctrltype">
+                    <span class="type">Control Type: </span><code>Image</code>
+                  </div>
+                  <div class="general">
+                    Descendants of the <code>canvas</code> element are mapped separately.
+                  </div>
                 </td>
                 <td class="atk">
                   <div class="role">
@@ -888,7 +891,8 @@ <h3>HTML Element Role Mappings</h3>
                   <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
                 </div>
                 <div class="general">
-                  Otherwise no accessible object. Styles used are mapped into text attributes on its text container.
+                  Otherwise no accessible object.
+                  Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -1133,22 +1137,21 @@ <h3>HTML Element Role Mappings</h3>
                   May not have an accessible object if has no semantic meaning. Otherwise,
                 </div>
                 <div class="role">
-                  <span class="type">Role: </span>
-                  <code>ATK_ROLE_SECTION</code>
+                  <span class="type">Role:</span> `ATK_ROLE_SECTION`
                 </div>
                  <div class="ifaces">
-                  <span class="type">Interfaces:</span> <code>AtkText</code>; <code>AtkHypertext</code>
+                  <span class="type">Interfaces:</span> `AtkText`; `AtkHypertext`
                 </div>
               </td>
               <td class="ax">
                 <div class="role">
-                  <span class="type">AXRole:</span> <code>AXGroup</code>
+                  <span class="type">AXRole:</span> `AXGroup`
                 </div>
                 <div class="subrole">
-                  <span class="type">AXSubrole:</span> <code>(nil)</code>
+                  <span class="type">AXSubrole:</span> `(nil)`
                 </div>
                 <div class="roledesc">
-                  <span class="type">AXRoleDescription:</span> <code>"group"</code>
+                  <span class="type">AXRoleDescription:</span> `"group"`
                 </div>
               </td>
               <td class="comments"></td>
@@ -1224,7 +1227,8 @@ <h3>HTML Element Role Mappings</h3>
                   <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
                 </div>
                 <div class="general">
-                  Otherwise no accessible object. Styles used are mapped into text attributes on its text container.
+                  Otherwise no accessible object.
+                  Styles used are mapped into text attributes on its text container.
                 </div>
               </td>
               <td class="ax">
@@ -2394,7 +2398,7 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="comments"></td>
             </tr>
-                <tr tabindex="-1" id="el-legend">
+            <tr tabindex="-1" id="el-legend">
                 <th><a data-cite="HTML">`legend`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
@@ -3078,19 +3082,20 @@ <h3>HTML Element Role Mappings</h3>
                     <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
                   </div>
                   <div class="general">
-                    Otherwise no accessible object. Styles are mapped into text attributes on its text container.
+                    Otherwise no accessible object.
+                    Styles are mapped into text attributes on its text container.
                   </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="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>
@@ -3217,13 +3222,13 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-source">
-                <th><a data-cite="HTML">`source`</a></th>
-                <td class="aria">No corresponding role</td>
-                <td class="ia2"><div class="general">Not mapped</div></td>
-                <td class="uia"><div class="general">Not mapped</div></td>
-                <td class="atk"><div class="general">Not mapped</div></td>
-                <td class="ax"><div class="general">Not mapped</div></td>
-                <td class="comments"></td>
+              <th><a data-cite="HTML">`source`</a></th>
+              <td class="aria">No corresponding role</td>
+              <td class="ia2"><div class="general">Not mapped</div></td>
+              <td class="uia"><div class="general">Not mapped</div></td>
+              <td class="atk"><div class="general">Not mapped</div></td>
+              <td class="ax"><div class="general">Not mapped</div></td>
+              <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-span">
               <th>
@@ -3278,15 +3283,15 @@ <h3>HTML Element Role Mappings</h3>
                   </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="role">
+                    <span class="type">AXRole:</span> `AXGroup`
+                  </div>
+                  <div class="subrole">
+                    <span class="type">AXSubrole:</span> `(nil)`
+                  </div>
+                  <div class="roledesc">
+                    <span class="type">AXRoleDescription:</span> `"group"`
+                  </div>
                 </td>
                 <td class="comments"></td>
             </tr>
@@ -3299,7 +3304,7 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="ax"><div class="general">Not mapped</div></td>
                 <td class="comments">
                   <div class="general">
-                    <b>Note:</b> There are instances where CSS properties can affect what is exposed by accessibility APIs. For instance, <code>display: none</code> or <code>visibility: hidden</code> will remove an element from the accessibility tree and hide its presence from assistive technologies.
+                    <strong>Note:</strong> There are instances where CSS properties can affect what is exposed by accessibility APIs. For instance, <code>display: none</code> or <code>visibility: hidden</code> will remove an element from the accessibility tree and hide its presence from assistive technologies.
                   </div>
                 </td>
             </tr>
@@ -3308,17 +3313,18 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
                   <div class="role">
-                    <span class="type">Roles: </span><code>ROLE_SYSTEM_TEXT</code>; <code>IA2_ROLE_TEXT_FRAME</code>
+                    <span class="type">Roles:</span> `ROLE_SYSTEM_TEXT`; `IA2_ROLE_TEXT_FRAME`
                   </div>
                   <div class="properties">
-                    <span class="type">Text attributes: </span><code>text-position:sub</code>
+                    <span class="type">Text attributes:</span> `text-position:sub`
                   </div>
                 </td>
                 <td class="uia">
                   <div class="ctrltype">
-                    <span class="type">Control Type: </span><code>Text</code>
+                    <span class="type">Control Type:</span> `Text`
                   </div>
-                  <div class="general">Styles used are exposed by <code>IsSubscript</code> attribute of the <code>TextRange</code> Control Pattern implemented on the accessible object.
+                  <div class="general">
+                    Styles used are exposed by `IsSubscript` attribute of the `TextRange` Control Pattern implemented on the accessible object.
                   </div>
                 </td>
                 <td class="atk">
@@ -3328,15 +3334,15 @@ <h3>HTML Element Role Mappings</h3>
                   </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>AXSubscriptStyleGroup</code>
-                    </div>
-                    <div class="roledesc">
-                        <span class="type">AXRoleDescription: </span><code>"group"</code>
-                    </div>
+                  <div class="role">
+                    <span class="type">AXRole: </span><code>AXGroup</code>
+                  </div>
+                  <div class="subrole">
+                    <span class="type">AXSubrole: </span><code>AXSubscriptStyleGroup</code>
+                  </div>
+                  <div class="roledesc">
+                    <span class="type">AXRoleDescription: </span><code>"group"</code>
+                  </div>
                 </td>
                 <td class="comments"></td>
             </tr>

From 15bf022337fc584ef76192bca8a5239d7271d77c Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 13:10:32 -0400
Subject: [PATCH 04/12] cleanup formatting

---
 index.html | 121 ++++++++++++++++++++++++++++-------------------------
 1 file changed, 65 insertions(+), 56 deletions(-)

diff --git a/index.html b/index.html
index 0e2b090b..7d03cc18 100644
--- a/index.html
+++ b/index.html
@@ -369,7 +369,9 @@ <h3>HTML Element Role Mappings</h3>
               <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-address">
-              <th><a data-cite="HTML">`address`</a></th>
+              <th>
+                <a data-cite="HTML">`address`</a>
+              </th>
               <td class="aria">No corresponding role</td>
               <td class="ia2">
                 <div class="role">
@@ -442,7 +444,9 @@ <h3>HTML Element Role Mappings</h3>
                   <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
               </td>
-              <td class="ax"><div class="general">Not mapped</div></td>
+              <td class="ax">
+                <div class="general">Not mapped</div>
+              </td>
               <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-article">
@@ -486,12 +490,12 @@ <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"><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>
+                <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">
@@ -647,10 +651,12 @@ <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>"blockquote"</code></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>"blockquote"</code>
+                  </div>
                 </td>
                 <td class="atk">
                   <div class="role">
@@ -663,15 +669,15 @@ <h3>HTML Element Role Mappings</h3>
                   </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="role">
+                    <span class="type">AXRole:</span> `AXGroup`
+                  </div>
+                  <div class="subrole">
+                    <span class="type">AXSubrole:</span> `(nil)`
+                  </div>
+                  <div class="roledesc">
+                    <span class="type">AXRoleDescription:</span> `"group"`
+                  </div>
                 </td>
                 <td class="comments"></td>
             </tr>
@@ -1122,15 +1128,17 @@ <h3>HTML Element Role Mappings</h3>
                   May not have an accessible object if has no semantic meaning. Otherwise,
                 </div>
                 <div class="role">
-                  <span class="type">Roles:</span> <code>ROLE_SYSTEM_GROUPING</code>; <code>IA2_ROLE_SECTION</code>
+                  <span class="type">Roles:</span> `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION`
                 </div>
                 <div class="ifaces">
                   <span class="type">Interfaces: </span>
-                  <code>IAccessibleText2</code>; <code>IAccessibleHypertext2</code>;
+                  `IAccessibleText2`; `IAccessibleHypertext2`;
                 </div>
               </td>
               <td class="uia">
-                <div class="ctrltype"><span class="type">Control Type:</span> <code>Group</code></div>
+                <div class="ctrltype">
+                  <span class="type">Control Type:</span> `Group`
+                </div>
               </td>
               <td class="atk">
                 <div class="general">
@@ -1482,7 +1490,7 @@ <h3>HTML Element Role Mappings</h3>
               <td class="ax"><div class="general">Use WAI-ARIA mapping</div></td>
               <td class="comments"></td>
             </tr>
-            <tr id="el-header2" tabindex="-1">
+            <tr tabindex="-1" id="el-form-noname">
               <th>
                 <a data-cite="HTML">`form`</a> without an <a class="termref">accessible name</a>
               </th>
@@ -1792,8 +1800,8 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
             </tr>
             <tr tabindex="-1" id="el-input-date">
-                <th>
-                  <a href="https://www.w3.org/TR/html/sec-forms.html#the-input-element"><code>input</code></a> <span class="el-context">(<a href="https://www.w3.org/TR/html/sec-forms.html#element-attrdef-input-type"><code>type</code></a> attribute in the <a href="https://www.w3.org/TR/html/sec-forms.html#date-state-typedate">Date</a> state)</span>
+              <th>
+                <a href="https://www.w3.org/TR/html/sec-forms.html#the-input-element"><code>input</code></a> <span class="el-context">(<a href="https://www.w3.org/TR/html/sec-forms.html#element-attrdef-input-type"><code>type</code></a> attribute in the <a href="https://www.w3.org/TR/html/sec-forms.html#date-state-typedate">Date</a> state)</span>
               </th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
@@ -2044,7 +2052,7 @@ <h3>HTML Element Role Mappings</h3>
                     <div class="ctrltype">
                         <span class="type">Localized Control Type: </span><code>"number"</code>
                     </div>
-              </td>
+                </td>
                 <td class="atk">
                   <div class="general">
                     If implemented as a spin button, use WAI-ARIA mapping for <a class="core-mapping" href="#role-map-spinbutton"><code>spinbutton</code></a>.
@@ -2360,9 +2368,9 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="uia">
-                    <div class="ctrltype">
-                        <span class="type">Control Type: </span><code>Text</code>
-                    </div>
+                  <div class="ctrltype">
+                    <span class="type">Control Type: </span><code>Text</code>
+                  </div>
                   <div class="properties">
                     <span class="type">Other properties: </span> When the <code>label</code> element contains an <code>input</code> element, the <code>LabeledBy</code> property for the <code>input</code> element points to the UIA element for the <code>label</code> element.
                     <p>When the <code>label</code> element has a <a href="#att-for-label"><code>for</code></a> attribute referencing another element, the <code>LabeledBy</code> property for the referenced element points to the UIA element for the <code>label</code> element.</p>
@@ -2370,8 +2378,7 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="atk">
                   <div class="role">
-                    <span class="type">Role: </span>
-                    <code>ATK_ROLE_LABEL</code>
+                    <span class="type">Role:</span> <code>ATK_ROLE_LABEL</code>
                   </div>
                   <div class="relations">
                     <span class="type">Relations: </span>
@@ -2883,7 +2890,7 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="uia">
                   <div class="ctrltype">
-                        <span class="type">Control Type: </span><code>Text</code>
+                    <span class="type">Control Type: </span><code>Text</code>
                   </div>
                   <div class="ctrltype"><span class="type">Localized Control Type:</span> <code>"q"</code></div>
                 </td>
@@ -2922,10 +2929,10 @@ <h3>HTML Element Role Mappings</h3>
                     <span class="type">AXRole: </span><code>AXGroup</code>
                   </div>
                   <div class="subrole">
-                      <span class="type">AXSubrole: </span><code>AXRubyBase</code>
+                    <span class="type">AXSubrole: </span><code>AXRubyBase</code>
                   </div>
                   <div class="roledesc">
-                      <span class="type">AXRoleDescription: </span><code>"group"</code>
+                    <span class="type">AXRoleDescription: </span><code>"group"</code>
                   </div>
                 </td>
                 <td class="comments"></td>
@@ -2936,7 +2943,8 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
                   <div class="general">
-                    No accessible object. No child elements are exposed if <a href="#el-ruby"><code>ruby</code></a> is supported by the browser.
+                    No accessible object.
+                    No child elements are exposed if <a href="#el-ruby">`ruby`</a> is supported by the browser.
                   </div>
                 </td>
                 <td class="uia">
@@ -2946,8 +2954,8 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="atk">
                   <div class="general">
-                    No accessible object. No child elements are
-                    exposed if <a href="#el-ruby"><code>ruby</code></a> is supported by the browser.
+                    No accessible object.
+                    No child elements are exposed if <a href="#el-ruby">`ruby`</a> is supported by the browser.
                   </div>
                 </td>
                 <td class="ax">Not mapped</td>
@@ -2958,7 +2966,8 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
                   <div class="general">
-                    No accessible object. No child elements are exposed if <a href="#el-ruby"><code>ruby</code></a> is supported by the browser.
+                    No accessible object.
+                    No child elements are exposed if <a href="#el-ruby">`ruby`</a> is supported by the browser.
                   </div>
                 </td>
                 <td class="uia">
@@ -2976,10 +2985,10 @@ <h3>HTML Element Role Mappings</h3>
                     <span class="type">AXRole: </span><code>AXGroup</code>
                   </div>
                   <div class="subrole">
-                      <span class="type">AXSubrole: </span><code>AXRubyText</code>
+                    <span class="type">AXSubrole: </span><code>AXRubyText</code>
                   </div>
                   <div class="roledesc">
-                      <span class="type">AXRoleDescription: </span><code>"group"</code>
+                    <span class="type">AXRoleDescription: </span><code>"group"</code>
                   </div>
                 </td>
                 <td class="comments"></td>
@@ -3033,7 +3042,7 @@ <h3>HTML Element Role Mappings</h3>
                   <!-- TODO add if mapped -->
                   <div class="general">No accessible object.</div>
                   <div class="properties">
-                    <span class="type">Text attributes: </span><code>text-line-through-style:solid</code> on the text container
+                    <span class="type">Text attributes:</span> `text-line-through-style:solid` on the text container
                   </div>
                 </td>
                 <td class="uia">
@@ -3046,19 +3055,19 @@ <h3>HTML Element Role Mappings</h3>
                     <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
                   </div>
                   <div class="general">
-                    Otherwise no accessible object. Exposed as
-                    "text-line-through-style:solid" text attribute on the text container.
+                    Otherwise no accessible object.
+                    Exposed as "text-line-through-style:solid" text attribute on the text container.
                   </div>
                 </td>
                 <td class="ax">
                   <div class="role">
-                    <span class="type">AXRole: </span><code>AXGroup</code>
+                    <span class="type">AXRole:</span> `AXGroup`
                   </div>
                   <div class="subrole">
-                    <span class="type">AXSubrole: </span><code>(nil)</code>
+                    <span class="type">AXSubrole:</span> `(nil)`
                   </div>
                   <div class="roledesc">
-                    <span class="type">AXRoleDescription: </span><code>"group"</code>
+                    <span class="type">AXRoleDescription:</span> `"group"`
                   </div>
                 </td>
                 <td class="comments"></td>
@@ -3088,13 +3097,13 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="ax">
                   <div class="role">
-                    <span class="type">AXRole: </span><code>AXGroup</code>
+                    <span class="type">AXRole:</span> `AXGroup`
                   </div>
                   <div class="subrole">
-                    <span class="type">AXSubrole: </span><code>(nil)</code>
+                    <span class="type">AXSubrole:</span> `(nil)`
                   </div>
                   <div class="roledesc">
-                    <span class="type">AXRoleDescription: </span><code>"group"</code>
+                    <span class="type">AXRoleDescription:</span> `"group"`
                   </div>
                 </td>
                 <td class="comments"></td>
@@ -3189,10 +3198,10 @@ <h3>HTML Element Role Mappings</h3>
                 <th><a data-cite="HTML">`small`</a></th>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
-                  <!-- add iff mapped -->
                   <div class="general">No accessible object.</div>
+                  <!-- add if mapped -->
                   <div class="properties">
-                    <span class="type">Text attributes: </span><code>font-size</code> on the text container
+                    <span class="type">Text attributes:</span> `font-size` on the text container
                   </div>
                 </td>
                 <td class="uia">
@@ -3210,13 +3219,13 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="ax">
                   <div class="role">
-                    <span class="type">AXRole: </span><code>AXGroup</code>
+                    <span class="type">AXRole:</span> `AXGroup`
                   </div>
                   <div class="subrole">
-                    <span class="type">AXSubrole: </span><code>(nil)</code>
+                    <span class="type">AXSubrole:</span> `(nil)`
                   </div>
                   <div class="roledesc">
-                    <span class="type">AXRoleDescription: </span><code>"group"</code>
+                    <span class="type">AXRoleDescription:</span> `"group"`
                   </div>
                 </td>
                 <td class="comments"></td>

From dc20857ba685515800ffa1d38414970f5a862bc3 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 19:36:13 -0400
Subject: [PATCH 05/12] If mapped
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* move “if mapped” prior to the role information.
* `b` AX update to “if mapped”.  Otherwise only the AXStaticText subtree is exposed.
* update ATK and AX mappings for `data` if mapped.
* update introduction of `div` mappings to “if mapped”
* `strong` AX update to “if mapped”. Otherwise only the AXStaticText subtree is exposed.
---
 index.html | 107 +++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 88 insertions(+), 19 deletions(-)

diff --git a/index.html b/index.html
index 7d03cc18..c4033336 100644
--- a/index.html
+++ b/index.html
@@ -536,8 +536,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
-                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="general">
                   Otherwise no accessible object.
@@ -545,6 +548,9 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="ax">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
                   <span class="type">AXRole:</span> `AXGroup`
                 </div>
@@ -585,8 +591,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
-                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="general">
                   Otherwise no accessible object.
@@ -615,8 +624,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
-                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="general">
                   Otherwise no accessible object.
@@ -855,8 +867,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
-                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="general">
                   Otherwise no accessible object. Styles used are mapped into text attributes on its text container.
@@ -893,8 +908,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
-                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="general">
                   Otherwise no accessible object.
@@ -983,8 +1001,31 @@ <h3>HTML Element Role Mappings</h3>
               <td class="aria"></td>
               <td class="ia2"><div class="general">Not mapped</div></td>
               <td class="uia"><div class="general">Not mapped</div></td>
-              <td class="atk"><div class="general">Not mapped</div></td>
-              <td class="ax"><div class="general">Not mapped</div></td>
+              <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
+                </div>
+              </td>
+              <td class="ax">
+                <div class="general">
+                  If mapped:
+                </div>
+                <div class="role">
+                  <span class="type">AXRole:</span> `AXGroup`
+                </div>
+                <div class="subrole">
+                  <span class="type">AXSubrole:</span> `(nil)`
+                </div>
+                <div class="roledesc">
+                  <span class="type">AXRoleDescription:</span> `"group"`
+                </div>
+                <div class="general">
+                  Otherwise no accessible object.
+                </div>
+              </td>
               <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-datalist">
@@ -1125,7 +1166,7 @@ <h3>HTML Element Role Mappings</h3>
               </td>
               <td class="ia2">
                 <div class="general">
-                  May not have an accessible object if has no semantic meaning. Otherwise,
+                  If mapped:
                 </div>
                 <div class="role">
                   <span class="type">Roles:</span> `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION`
@@ -1142,7 +1183,7 @@ <h3>HTML Element Role Mappings</h3>
               </td>
               <td class="atk">
                 <div class="general">
-                  May not have an accessible object if has no semantic meaning. Otherwise,
+                  If mapped:
                 </div>
                 <div class="role">
                   <span class="type">Role:</span> `ATK_ROLE_SECTION`
@@ -1231,8 +1272,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
-                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="general">
                   Otherwise no accessible object.
@@ -1644,8 +1688,11 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
-                  <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
                 </div>
                 <div class="general">
                   Otherwise no accessible object. Exposed as "font-style:italic" text attribute on its text container.
@@ -2333,8 +2380,11 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
-                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC`
                   </div>
                   <div class="general">
                     Otherwise no accessible object. Mapped into "font-family:monospace" text attribute on its text container.
@@ -3051,8 +3101,11 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
-                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC`
                   </div>
                   <div class="general">
                     Otherwise no accessible object.
@@ -3087,8 +3140,11 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
-                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC`
                   </div>
                   <div class="general">
                     Otherwise no accessible object.
@@ -3210,8 +3266,11 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
-                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC`
                   </div>
                   <div class="general">
                     Otherwise no accessible object. Exposed as "font-size" text attribute on the text container.
@@ -3284,14 +3343,21 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
-                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC`
                   </div>
                   <div class="general">
-                    No accessible object. Styles used are mapped into text attributes on its text container.
+                    Otherwise no accessible object.
+                    Styles used are mapped into text attributes on its text container.
                   </div>
                 </td>
                 <td class="ax">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
                     <span class="type">AXRole:</span> `AXGroup`
                   </div>
@@ -3672,8 +3738,11 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="atk">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
-                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                    <span class="type">Role:</span> `ATK_ROLE_STATIC`
                   </div>
                   <div class="general">
                     Otherwise no accessible object. Styles used are mapped to text attributes on its text container.
@@ -3733,7 +3802,7 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="aria">No corresponding role</td>
                 <td class="ia2">
                   <div class="general">
-                    If a line break is added, expose it with <code>IAccessibleText</code> on the text container.
+                    If a line break is added, expose it with `IAccessibleText` on the text container.
                   </div>
                 </td>
                 <td class="uia"><div class="general">Not mapped</div></td>

From 4107fc9acea2746a7da2dcab85a1943ccef5e107 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 20:34:02 -0400
Subject: [PATCH 06/12] update AX mappings
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* update `i` to “if mapped”
* update `s` to “if mapped”
* update `span` to “if mapped”

note: reverified that `var`, `kbd`, `samp`, `code` all map to `AXGroup` without assistance from an attribute like `aria-label` or `tabindex` to promote them as an accessible object.
---
 index.html | 39 ++++++++++++++++++++++++---------------
 1 file changed, 24 insertions(+), 15 deletions(-)

diff --git a/index.html b/index.html
index c4033336..82f3ed57 100644
--- a/index.html
+++ b/index.html
@@ -1699,6 +1699,9 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="ax">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
                   <span class="type">AXRole: </span><code>AXGroup</code>
                 </div>
@@ -2390,18 +2393,18 @@ <h3>HTML Element Role Mappings</h3>
                     Otherwise no accessible object. Mapped into "font-family:monospace" text attribute on its text container.
                   </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>
-                </td>
-                <td class="comments"></td>
+              <td class="ax">
+                <div class="role">
+                  <span class="type">AXRole:</span> `AXGroup`
+                </div>
+                <div class="subrole">
+                  <span class="type">AXSubrole:</span> `(nil)`
+                </div>
+                <div class="roledesc">
+                  <span class="type">AXRoleDescription:</span> `"group"`
+                </div>
+              </td>
+              <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-label">
                 <th><a data-cite="HTML">`label`</a></th>
@@ -3113,6 +3116,9 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="ax">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
                     <span class="type">AXRole:</span> `AXGroup`
                   </div>
@@ -3316,6 +3322,9 @@ <h3>HTML Element Role Mappings</h3>
                 <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
               </td>
               <td class="ax">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
                   <span class="type">AXRole:</span> `AXGroup`
                 </div>
@@ -3750,13 +3759,13 @@ <h3>HTML Element Role Mappings</h3>
                 </td>
                 <td class="ax">
                   <div class="role">
-                    <span class="type">AXRole: </span><code>AXGroup</code>
+                    <span class="type">AXRole:</span> `AXGroup`
                   </div>
                   <div class="subrole">
-                    <span class="type">AXSubrole: </span><code>(nil)</code>
+                    <span class="type">AXSubrole:</span> `(nil)`
                   </div>
                   <div class="roledesc">
-                    <span class="type">AXRoleDescription: </span><code>"group"</code>
+                    <span class="type">AXRoleDescription:</span> `"group"`
                   </div>
                 </td>
                 <td class="comments"></td>

From 89bf6afc24df0f04fe57c8c0e13f846911a987ac Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 22:11:49 -0400
Subject: [PATCH 07/12] u cleanup

---
 index.html | 58 +++++++++++++++++++++++++++++++++---------------------
 1 file changed, 36 insertions(+), 22 deletions(-)

diff --git a/index.html b/index.html
index 82f3ed57..855734f9 100644
--- a/index.html
+++ b/index.html
@@ -3702,28 +3702,42 @@ <h3>HTML Element Role Mappings</h3>
                 <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-u">
-                <th><a data-cite="HTML">`u`</a></th>
-                <td class="aria">No corresponding role</td>
-                <td class="ia2">
-                  <!-- TODO add if mapped -->
-                  <div class="general">No accessible object. Exposed as "text-underline-style:solid" text attribute on its text container.
-                  </div>
-                </td>
-                <td class="uia">
-                  <!-- TODO add if mapped -->
-                  <div class="general">No accessible object. Exposed by <code>UnderlineStyle</code> attribute of the <code>TextRange</code> Control Pattern implemented on a parent accessible object.
-                  </div>
-                </td>
-                <td class="atk">
-                  <div class="role">
-                    <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
-                  </div>
-                  <div class="general">
-                    Otherwise no accessible object. Exposed as "text-underline-style:solid" text attribute on its text container.
-                  </div>
-                </td>
-                <td class="ax">?</td>
-                <td class="comments"></td>
+              <th><a data-cite="HTML">`u`</a></th>
+              <td class="aria">No corresponding role</td>
+              <td class="ia2">
+                <div class="general">
+                  If mapped:
+                </div>
+                <!-- TODO add if mapped -->
+                <div class="general">
+                  Otherwise no accessible object.
+                  Exposed as "text-underline-style:solid" text attribute on its text container.
+                </div>
+              </td>
+              <td class="uia">
+                <div class="general">
+                  If mapped:
+                </div>
+                <!-- TODO add if mapped -->
+                <div class="general">
+                  Otherwise no accessible object.
+                  Exposed by `UnderlineStyle` attribute of the `TextRange` Control Pattern implemented on a parent accessible object.
+                </div>
+              </td>
+              <td class="atk">
+                <div class="general">
+                  If mapped:
+                </div>
+                <div class="role">
+                  <span class="type">Role:</span> `ATK_ROLE_STATIC`
+                </div>
+                <div class="general">
+                  Otherwise no accessible object.
+                  Exposed as "text-underline-style:solid" text attribute on its text container.
+                </div>
+              </td>
+              <td class="ax">?</td>
+              <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-ul">
                 <th><a data-cite="HTML">`ul`</th>

From f70f1e56f6b5a1154d6e9fb04600063b8bde0f08 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 22:12:34 -0400
Subject: [PATCH 08/12] add AX mapping for <u>

---
 index.html | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 855734f9..d6647160 100644
--- a/index.html
+++ b/index.html
@@ -3736,7 +3736,20 @@ <h3>HTML Element Role Mappings</h3>
                   Exposed as "text-underline-style:solid" text attribute on its text container.
                 </div>
               </td>
-              <td class="ax">?</td>
+              <td class="ax">
+                <div class="general">
+                  If mapped:
+                </div>
+                <div class="role">
+                  <span class="type">AXRole:</span> `AXGroup`
+                </div>
+                <div class="subrole">
+                  <span class="type">AXSubrole:</span> `(nil)`
+                </div>
+                <div class="roledesc">
+                  <span class="type">AXRoleDescription:</span> `"group"`
+                </div>
+              </td>
               <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-ul">

From 84db0c65e8e1bed99a54856ae3dbc23514160d72 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 22:13:11 -0400
Subject: [PATCH 09/12] edit wording for span if mapped atk

---
 index.html | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/index.html b/index.html
index d6647160..47accead 100644
--- a/index.html
+++ b/index.html
@@ -3319,7 +3319,10 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="atk">
-                <span class="type">Role:</span> `ATK_ROLE_STATIC` (if mapped)
+                <div class="general">
+                  If mapped:
+                </div>
+                <span class="type">Role:</span> `ATK_ROLE_STATIC`
               </td>
               <td class="ax">
                 <div class="general">

From b6ca399d4b47d547c17743584cbc35784c40983b Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 22:19:56 -0400
Subject: [PATCH 10/12] AX small update

note that only if mapped
---
 index.html | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/index.html b/index.html
index 47accead..5cc1fd23 100644
--- a/index.html
+++ b/index.html
@@ -3283,6 +3283,9 @@ <h3>HTML Element Role Mappings</h3>
                   </div>
                 </td>
                 <td class="ax">
+                  <div class="general">
+                    If mapped:
+                  </div>
                   <div class="role">
                     <span class="type">AXRole:</span> `AXGroup`
                   </div>

From 66d13b99e6fa5b04974ef5674d6342fc27869f08 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 22:31:46 -0400
Subject: [PATCH 11/12] add bdi AX mappings

---
 index.html | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 5cc1fd23..8ae9f3cc 100644
--- a/index.html
+++ b/index.html
@@ -602,7 +602,20 @@ <h3>HTML Element Role Mappings</h3>
                   May affect on "writing-mode" text attribute on its text container.
                 </div>
               </td>
-              <td class="ax"></td>
+              <td class="ax">
+                <div class="general">
+                  If mapped:
+                </div>
+                <div class="role">
+                  <span class="type">AXRole:</span> `AXGroup`
+                </div>
+                <div class="subrole">
+                  <span class="type">AXSubrole:</span> `(nil)`
+                </div>
+                <div class="roledesc">
+                  <span class="type">AXRoleDescription:</span> `"group"`
+                </div>
+              </td>
               <td class="comments"></td>
             </tr>
             <tr tabindex="-1" id="el-bdo">

From a0ae51105b10a8fa0a95005b4b233ab16452ee2b Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Sat, 27 Jul 2019 22:32:22 -0400
Subject: [PATCH 12/12] update bdo AX mapping

note that AXGroup only if mapped
---
 index.html | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/index.html b/index.html
index 8ae9f3cc..478e0293 100644
--- a/index.html
+++ b/index.html
@@ -649,6 +649,9 @@ <h3>HTML Element Role Mappings</h3>
                 </div>
               </td>
               <td class="ax">
+                <div class="general">
+                  If mapped:
+                </div>
                 <div class="role">
                   <span class="type">AXRole:</span> `AXGroup`
                 </div>