Skip to content

Clarification of 2.5.3 Label in Name understanding (case insensitivity)#4836

Merged
patrickhlauke merged 10 commits intomainfrom
patrickhlauke-issue3812
Apr 5, 2026
Merged

Clarification of 2.5.3 Label in Name understanding (case insensitivity)#4836
patrickhlauke merged 10 commits intomainfrom
patrickhlauke-issue3812

Conversation

@patrickhlauke
Copy link
Copy Markdown
Member

@patrickhlauke patrickhlauke commented Dec 28, 2025

While the understanding document https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html does mention that capitalization "may" be irrelevant, the advice buries the lede. This makes it a lot more obvious and explicit, while also mentioning that as best practice capitalization/matching accName and visible label may be meaningful for SR users.


In addition, one aspect that always felt strange and out of place in the understanding was the use of inline "live" examples.

screenshot of the understanding document, showing the inline live examples circled

They look amateurish, and the first two don't actually "work" - the accessible names of the controls match exactly what the visible labels are. Replaced these with figures AND code samples that do actually show a divergence between label and accName in terms of punctuation/capitalization.

Lastly, this PR fixes some awkwardness in the prose for the mathematical section.


Closes #3812

Preview: https://deploy-preview-4836--wcag2.netlify.app/understanding/label-in-name
HTML diff

@patrickhlauke patrickhlauke self-assigned this Dec 28, 2025
@netlify
Copy link
Copy Markdown

netlify Bot commented Dec 28, 2025

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit cc5427c
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/69d2b667e107770008301d3e
😎 Deploy Preview https://deploy-preview-4836--wcag2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@bruce-usab
Copy link
Copy Markdown
Contributor

This precedes my #4897 so I will see if there is anything for me to add to this one and then close the other.

Copy link
Copy Markdown
Contributor

@bruce-usab bruce-usab left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very nice! Diff preview at “Punctuation and capitalization” — but please be aware that diff does not show the new images, and makes a hash of the code samples.

@bruce-usab
Copy link
Copy Markdown
Contributor

Closes #4897

@patrickhlauke patrickhlauke merged commit b69e763 into main Apr 5, 2026
8 checks passed
@patrickhlauke patrickhlauke deleted the patrickhlauke-issue3812 branch April 5, 2026 19:23
fstrr pushed a commit that referenced this pull request Apr 8, 2026
…y) (#4836)

While the understanding document
https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html does
mention that capitalization "may" be irrelevant, the advice buries the
lede. This makes it a lot more obvious and explicit, while also
mentioning that as best practice capitalization/matching accName and
visible label may be meaningful for SR users.

---

In addition, one aspect that always felt strange and out of place in the
understanding was the use of inline "live" examples.

![screenshot of the understanding document, showing the inline live
examples
circled](https://github.com/user-attachments/assets/21f0fef3-a90c-4414-bd27-89556e2617d8)

They look amateurish, and the first two don't actually "work" - the
accessible names of the controls match exactly what the visible labels
are. Replaced these with figures AND code samples that *do* actually
show a divergence between label and accName in terms of
punctuation/capitalization.

Lastly, this PR fixes some awkwardness in the prose for the mathematical
section.

---

Closes #3812

Preview:
https://deploy-preview-4836--wcag2.netlify.app/understanding/label-in-name
[HTML
diff](https://services.w3.org/htmldiff?doc1=https%3A%2F%2Fwww.w3.org%2FWAI%2FWCAG22%2FUnderstanding%2Flabel-in-name&doc2=https%3A%2F%2Fdeploy-preview-4836--wcag2.netlify.app%2Funderstanding%2Flabel-in-name)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2.5.3 Label in Name - case insensitve?

4 participants