Orange-OpenSource / Orange-OpenSource/Orange-Boosted-Bootstrap
[docs] text-area: "Helper link" example missing aria-describedby on textarea
Nobody has claimed this yet.
- Dominant language
- CSS
- Stars
- 219
- Forks
- 61
- Avg merge
- 2d 15h
- Merged PRs (30d)
- 12
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
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.
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.
Assessment
- Tech stack
- html
- Domain
- accessibility, documentation
- Issue type
- Bug
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 88/100