Skip to content

Commit

Permalink
add accessible name & desc definitions
Browse files Browse the repository at this point in the history
  • Loading branch information
jnurthen committed Jul 16, 2021
1 parent 82a5087 commit 65a6358
Showing 1 changed file with 10 additions and 1 deletion.
11 changes: 10 additions & 1 deletion index.html
Expand Up @@ -142,7 +142,7 @@
preProcess: [ linkCrossReferences ],
postProcess: [ ],
//Pointing to the 1.2 versions but should remove the version in the publishing branch
xref: ["core-aam-1.2", "wai-aria-1.2"]
xref: ["dom", "core-aam-1.2", "wai-aria-1.2", "infra"]
}
</script>
</head>
Expand All @@ -167,6 +167,15 @@ <h1>Important Terms</h1>
<div>
<p>While some terms are defined in place, the following definitions are used throughout this document. </p>
<dl class="termlist">
<dt><dfn data-export="">Accessible Description</dfn></dt>
<dd>
<p>An accessible description provides additional information, related to an interface element, that complements the <a>accessible name</a>. The accessible description might or might not be visually perceivable. </p>
</dd>
<dt><dfn data-export="">Accessible Name</dfn></dt>
<dd>
<p>The accessible name is the name of a user interface element. Each platform <a>accessibility <abbr title="application programming interface">API</abbr></a> provides the accessible name property. The value of the accessible name may be derived from a visible (e.g., the visible text on a button) or invisible (e.g., the text alternative that describes an icon) property of the user interface element. See related <a>accessible description</a>.</p>
<p>A simple use for the accessible name property may be illustrated by an &quot;OK&quot; button. The text &quot;OK&quot; is the accessible name. When the button receives focus, assistive technologies may concatenate the platform's role description with the accessible name. For example, a screen reader may speak &quot;push-button OK&quot; or &quot;OK button&quot;. The order of concatenation and specifics of the role description (e.g., &quot;button&quot;, &quot;push-button&quot;, &quot;clickable button&quot;) are determined by platform <a class="termref">accessibility API</a>s or <a>assistive technologies</a>.</p>
</dd>
<dt><dfn data-no>Tooltip attribute</dfn></dt>
<dd>
<p>Any host language attribute that would result in a user agent generating a tooltip such as in response to a mouse hover in desktop user agents.</p>
Expand Down

0 comments on commit 65a6358

Please sign in to comment.