add accessible name & desc definitions

jnurthen · jnurthen · commit 65a6358433a7 · 2021-07-15T17:47:43.000-07:00
diff --git a/index.html b/index.html
@@ -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>
@@ -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>
