Skip to content

Commit 0cda2e0

Browse files
committed
Expand notes for 2.5.3
1 parent a9a18b0 commit 0cda2e0

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

comments/2.5.3.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,10 @@
77

88
This applies directly as written, and as described in Intent from [Understanding Success Criterion 2.5.3](https://www.w3.org/WAI/WCAG22/Understanding/label-in-name#intent).
99

10-
[note: When user interface components have nested controls, the name should include the primary visible label but is not required to contain all presented text.]
10+
**2.5.3 Label in Name:** For [user interface components](https://www.w3.org/TR/WCAG22/#dfn-user-interface-components) with [labels](https://www.w3.org/TR/WCAG22/#dfn-labels) that include [text](https://www.w3.org/TR/WCAG22/#dfn-text) or [images of text](https://www.w3.org/TR/WCAG22/#dfn-images-of-text), the [name](https://www.w3.org/TR/WCAG22/#dfn-name) contains the text that is presented visually.
11+
12+
[note:A best practice is to have the text of the label at the start of the name. This ensures voice users can activate controls with voice commands.]
13+
14+
[note:Some controls such as tiles, cards, or list items may include multiple text components. While all visible text should be available to assistive technologies, only text that serves as the primary label needs to be included in the accessible name.]
15+
16+
[note:Custom accessibility actions that group multiple functions may use descriptive names like "actions available" for assistive technologies.]

0 commit comments

Comments
 (0)