Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions comments/2.5.3.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,11 @@
[wcag2ict:applying-sc-2-5-3-label-in-name-to-non-web-documents-and-software]

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).

**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.

[note:A best practice is to have the text of the label at the start of the name. This is particularly important for voice control users who rely on speaking the visible text to interact with user interface components.]

[note:Some user interface components such as tiles, cards, or list items may include multiple text components. The text that serves as the primary label must be contained in the name. Other visible text components may be exposed through other accessibility properties.]

[note:Custom accessibility actions that group multiple functions may use descriptive names like "actions available" for assistive technologies.]
6 changes: 6 additions & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3170,6 +3170,12 @@ <h2>Success Criterion 2.5.3 Label in Name</h2>
</details>
</p>
<p>This applies directly as written, and as described in Intent from <a href="https://www.w3.org/WAI/WCAG22/Understanding/label-in-name#intent">Understanding Success Criterion 2.5.3</a>.</p>
<p>
<div class="note">
<p>When user interface components have nested controls, the name should include the primary visible label but is not required to contain all presented text.</p>

</div>
</p>

</section>

Expand Down