GeezerVison is showing github.com — add accessible name & desc definitions · w3c/accname@65a6358
File tree
Expand file treeCollapse file tree
Open diff view settings
Expand file treeCollapse file tree
Open diff view settings
Collapse file
Copy file name to clipboardExpand all lines: index.html +10-1Lines changed: 10 additions & 1 deletion | Original file line number | Diff line number | Diff line change |
|---|
|
142 | 142 | preProcess: [ linkCrossReferences ], |
143 | 143 | postProcess: [ ], |
144 | 144 | //Pointing to the 1.2 versions but should remove the version in the publishing branch |
145 | | - xref: ["core-aam-1.2", "wai-aria-1.2"] |
| 145 | + xref: ["dom", "core-aam-1.2", "wai-aria-1.2", "infra"] |
146 | 146 | } |
147 | 147 | </script> |
148 | 148 | </head> |
@@ -167,6 +167,15 @@ <h1>Important Terms</h1> |
167 | 167 | <div> |
168 | 168 | <p>While some terms are defined in place, the following definitions are used throughout this document. </p> |
169 | 169 | <dl class="termlist"> |
| 170 | + <dt><dfn data-export="">Accessible Description</dfn></dt> |
| 171 | + <dd> |
| 172 | + <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> |
| 173 | + </dd> |
| 174 | + <dt><dfn data-export="">Accessible Name</dfn></dt> |
| 175 | + <dd> |
| 176 | + <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> |
| 177 | + <p>A simple use for the accessible name property may be illustrated by an "OK" button. The text "OK" 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 "push-button OK" or "OK button". The order of concatenation and specifics of the role description (e.g., "button", "push-button", "clickable button") are determined by platform <a class="termref">accessibility API</a>s or <a>assistive technologies</a>.</p> |
| 178 | + </dd> |
170 | 179 | <dt><dfn data-no>Tooltip attribute</dfn></dt> |
171 | 180 | <dd> |
172 | 181 | <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> |
|