Skip to content

Commit 93875f2

Browse files
authored
Merge pull request #120 from w3c/fix-acc-name-ref
Fix respec errors related to ambigious spec references to "Accessible Name" and "Accessible Description"
2 parents 264accd + 7e7e34f commit 93875f2

File tree

2 files changed

+7379
-5
lines changed

2 files changed

+7379
-5
lines changed

index.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -256,11 +256,11 @@ <h5>UIA (UI Automation)</h5>
256256
</section>
257257
<section>
258258
<h5>Accessible Names and Descriptions</h5>
259-
<p>Each platform accessibility API includes a way to assign and retrieve <a class="termref">accessible name</a> and <a class="termref">accessible description</a> properties for each <a class="termref">accessible object</a> created in the <a class="termref">accessibility tree</a>. How these properties are implemented and what they are called vary depending on the API.</p>
260-
<p>For instance, in MSAA, all <a class="termref">accessible objects</a> support the <code>accName</code> property, which stores the object's <a class="termref">accessible name</a>. Where the object also supports having an <a class="termref">accessible description</a>, MSAA stores this property in the object's <code>accDescription</code> property.</p>
259+
<p>Each platform accessibility API includes a way to assign and retrieve <a class="termref" data-cite="accname-1.2#dfn-accessible-name">accessible name</a> and <a class="termref" data-cite="accname-1.2#dfn-accessible-description">accessible description</a> properties for each <a class="termref">accessible object</a> created in the <a class="termref">accessibility tree</a>. How these properties are implemented and what they are called vary depending on the API.</p>
260+
<p>For instance, in MSAA, all <a class="termref">accessible objects</a> support the <code>accName</code> property, which stores the object's <a class="termref" data-cite="accname-1.2#dfn-accessible-name">accessible name</a>. Where the object also supports having an <a class="termref" data-cite="accname-1.2#dfn-accessible-description">accessible description</a>, MSAA stores this property in the object's <code>accDescription</code> property.</p>
261261
<p>Software using ATK can read and write to an object's <code>accessible-name</code> and <code>accessible-description</code> properties. In turn, AT-SPI can query the values of those properties through its <code>atspi_accessible_get_name</code> and <code>atspi_accessible_get_description</code> functions.</p>
262-
<p>Automation elements in the UIA accessibility tree have a <code>Name</code> property. Where the object also supports having an <a class="termref">accessible description</a>, UIA stores this property in the object's <code>FullDescription</code> property.</p>
263-
<p>The approach to <a class="termref">accessible names</a> and <a class="termref" data-lt="accessible description">accessible descriptions</a> in AX API is somewhat different to the other platform APIs. <a class="termref">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">accessible description</a>, where provided, should always be exposed in the <code>AXHelp</code> property.</p>
262+
<p>Automation elements in the UIA accessibility tree have a <code>Name</code> property. Where the object also supports having an <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>
263+
<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, should always be exposed in the <code>AXHelp</code> property.</p>
264264
<p>For more detail, see the <a class="accname" href="">Accessible Name and Description Computation</a> specification.</p>
265265
</section>
266266
</section>
@@ -3972,7 +3972,7 @@ <h4>Not Mapped</h4>
39723972
<h2>Special Processing Requiring Additional Computation</h2>
39733973
<section id="mapping_additional_nd">
39743974
<h3>Name and Description</h3>
3975-
<p>For information on how to compute an <a class="termref">accessible name</a> or <a class="termref">accessible description</a>, see the section titled <a class="accname" href="#mapping_additional_nd_te">Accessible Name and Description Computation</a> of the <a class="accname" href="">Accessible Name and Description Computation</a> specification.</p>
3975+
<p>For information on how to compute an <a class="termref" data-cite="accname-1.2#dfn-accessible-name">accessible name</a> or <a class="termref" data-cite="accname-1.2#dfn-accessible-description">accessible description</a>, see the section titled <a class="accname" href="#mapping_additional_nd_te">Accessible Name and Description Computation</a> of the <a class="accname" href="">Accessible Name and Description Computation</a> specification.</p>
39763976
</section>
39773977
<section id="mapping_additional_relations">
39783978
<h3>Relations</h3>

0 commit comments

Comments
 (0)