Merge pull request #2199 from w3c/monorepo_history--core-aam--PR230

rahimabdi · web-flow · commit 0a0da0bff75c · 2025-03-27T14:55:19.000-07:00
[core-aam PR 230] Update aria-labelledby AXAPI mapping to use AXTitle
diff --git a/core-aam/index.html b/core-aam/index.html
@@ -356,11 +356,7 @@ <h5>Accessible Names and Descriptions</h5>
             <a class="termref" data-cite="accname-1.2#dfn-accessible-description">accessible description</a>, UIA stores this property in the object's <code>FullDescription</code> property.
           </p>
           <p>
-            The approach to <a class="termref" data-cite="accname-1.2#dfn-accessible-name">accessible names</a> and
-            <a class="termref" data-lt="accessible description" data-cite="accname-1.2#dfn-accessible-description">accessible descriptions</a> in AX API is somewhat different to the other platform
-            APIs. <a class="termref" data-cite="accname-1.2#dfn-accessible-name">Accessible names</a> are exposed using the <code>AXTitle</code> property when the name is visually rendered, while the
-            <code>AXDescription</code> property is used when the object's name is not rendered visually. An object's
-            <a class="termref" data-cite="accname-1.2#dfn-accessible-description">accessible description</a>, where provided by
+            An object's <a class="termref" data-cite="accname-1.2#dfn-accessible-description">accessible description</a>, where provided by
             <a class="state-reference" href="#aria-description"><code>aria-description</code></a> or <a class="state-reference" href="#aria-describedby"><code>aria-describedby</code></a
             >, should be exposed in the <code>accessibilityCustomContent</code> API. Otherwise, it should be exposed as <code>AXHelp</code>.
           </p>
@@ -7945,7 +7941,7 @@ <h4 id="ariaLabel"><code>aria-label</code></h4>
               <tr>
                 <th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
                 <td>
-                  <span class="property">Property: <code>AXDescription</code>: <code>&lt;value&gt;</code></span
+                  <span class="property">Property: <code>AXTitle</code>: <code>&lt;value&gt;</code></span
                   ><br />
                   <span class="seealso">See also: <a href="#mapping_additional_nd">Name Computation</a></span>
                 </td>
@@ -7994,8 +7990,8 @@ <h4 id="ariaLabelledBy"><code>aria-labelledby</code></h4>
               <tr>
                 <th><abbr title="macOS Accessibility Protocol">AX API</abbr></th>
                 <td>
-                  <span class="property">Property: <code>AXDescription</code>: <code>&lt;value&gt;</code></span> if the value is not exposed visually<br />
-                  <span class="property">Property: <code>AXTitle</code>: <code>&lt;value&gt;</code></span> if the value is exposed visually<br />
+                  <span class="property">Property: <code>AXTitle</code>: <code>&lt;value&gt;</code></span
+                  ><br />
                   <span class="property"
                     >Property: <code>AXTitleUIElement</code> points to accessible node matching IDREF, if there is a single referenced element that is in the accessibility tree</span
                   ><br />

-Original file line number
+Diff line change
             accessible description, UIA stores this property in the object's FullDescription property.
 -            The approach to accessible names and
 -            accessible descriptions in AX API is somewhat different to the other platform
 -            APIs. Accessible names are exposed using the AXTitle property when the name is visually rendered, while the
 -            AXDescription property is used when the object's name is not rendered visually. An object's
 -            accessible description, where provided by
 +            An object's accessible description, where provided by
             aria-description or aria-describedby
             >, should be exposed in the accessibilityCustomContent API. Otherwise, it should be exposed as AXHelp.
 AX API
 -                  Property: AXDescription: <value>
 +                  Property: AXTitle: <value>
+                  >
                   See also: Name Computation
 AX API
 -                  Property: AXDescription: <value>> if the value is not exposed visually
 -                  Property: AXTitle: <value> if the value is exposed visually
 +                  Property: AXTitle: <value>
 +                  >
                     >Property: AXTitleUIElement points to accessible node matching IDREF, if there is a single referenced element that is in the accessibility tree
+                  >