[docs] text-area: "Helper link" example missing aria-describedby on textarea
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 88/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- html
- Domain
- accessibility, documentation
Research direction
Open the text-area documentation's “Helper link” section and compare its second example with the equivalent text-input example. Update the textarea markup so it references the “More information” link through aria-describedby, then verify that the rendered example matches the expected HTML and remains accessible.
Written by the indexing model from the issue text.
Description
Prerequisites
- I have searched for duplicate or closed issues and checked on main that it still appears.
- I have read the contributing guidelines
Describe the issue
Title
[docs] text-area: "Helper link" example missing aria-describedby on textarea
Affected page
https://web.unified-design-system.orange.com/orange/docs/1.4/components/text-area/#helper-link
Description
In the second example of the "Helper link" section (the one with a link but no helper text), the <textarea> does not have an aria-describedby attribute referencing the link, unlike the equivalent example in the text-input documentation which does.
Current (buggy) HTML
<div class="text-area">
<div class="text-area-container mt-large">
<label id="labelTextAreaHelperLink" for="textAreaHelperLink">Additional comments</label>
<textarea id="textAreaHelperLink" class="text-area-field" placeholder=" "></textarea>
</div>
<a href="#" id="feedbackTextHelpMoreLink" aria-labelledby="feedbackTextHelpMoreLink labelTextAreaHelperLink" class="link link-small">
More information <span class="visually-hidden">on</span>
</a>
</div>
Expected HTML
(matching the text-input equivalent at https://web.unified-design-system.orange.com/orange/docs/1.4/components/text-input/#helper-link)
<div class="text-area">
<div class="text-area-container mt-large">
<label id="labelTextAreaHelperLink" for="textAreaHelperLink">Additional comments</label>
<textarea id="textAreaHelperLink" aria-describedby="feedbackTextHelpMoreLink" class="text-area-field" placeholder=" "></textarea>
</div>
<a href="#" id="feedbackTextHelpMoreLink" aria-labelledby="feedbackTextHelpMoreLink labelTextAreaHelperLink" class="link link-small">
More information <span class="visually-hidden">on</span>
</a>
</div>
Why this matters
Without aria-describedby, screen reader users are not informed that a related "More information" link exists for the field. The text-input component's identical pattern (field + label + link, no helper text) correctly wires this via aria-describedby, so text-area should be consistent.
Any information that could help to resolve the issue. (window.navigator.userAgent)
No response
What version of the documentation are you using?
1.4.0
- Dominant language
- CSS
- Stars
- 219
- Forks
- 61
- Avg merge
- 2d 15h
- Merged PRs (30d)
- 12
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Orange-OpenSource/Orange-Boosted-Bootstrap
-
📖 documentation 🧩 enhancement
Difficulty 1/5 Under an hour Newbie friendliness 76/100
-
🐞 bug 🧰 library
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
-
🛠️ technical github_actions
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Orange-OpenSource/Orange-Boosted-Bootstrap#3780 · 1 reaction ·
-
🐞 bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Orange-OpenSource/Orange-Boosted-Bootstrap#3775 · 1 comment ·
-
🧰 library
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
All issues in Orange-OpenSource/Orange-Boosted-Bootstrap
Similar issues
-
accessibility angular bug good first issue typescript ux
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
apache/fineract-backoffice-ui#584 · 1 comment ·
-
bug
Difficulty 1/5 1-3 hours Newbie friendliness 88/100
spartan-ng/spartan#1763 ·
-
Access Score Gallery Label Map
Difficulty 2/5 Half a day Newbie friendliness 68/100
ProjectSidewalk/SidewalkWebpage#5430 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100