ARIA treeitem nodes should have an accessible name
Rule ID:
aria-treeitem-name
Ruleset:
axe-core 4.6
User Impact:
Serious
Guidelines:
Deque Best Practice
Need accessibility training?
Deque University offers an extensive curriculum of self-guided online courses for every skillset and experience level.
Compliance Data & Impact
How to Fix the Problem
Correct markup solutions
The aria-treeitem-name rule has four markup patterns that pass
test criteria:
<div role="treeitem" id="al" aria-label="Name"></div>
<div role="treeitem" id="alb" aria-labelledby="labeldiv"></div>
<div role="treeitem" id="combo" aria-label="Aria Name">Name</div>
<div role="treeitem" id="title" title="Title"></div>
-
Ensure that each element with
role="treeitem"has one of the following characteristics:- Inner text that is discernible to screen reader users.
- Non-empty
aria-labelattribute. -
aria-labelledbypointing to element with text which is discernible to screen reader users.
Incorrect markup solutions
The aria-treeitem-name rule has four markup patterns that fail
testing criteria:
<div role="treeitem" id="empty"></div>
<div role="treeitem" id="alempty" aria-label=""></div>
<div role="treeitem" id="albmissing" aria-labelledby="nonexistent"></div>
<div role="treeitem" id="albempty" aria-labelledby="emptydiv"></div>
<div id="emptydiv"></div>Why it Matters
Screen reader users are not able to discern the purpose of elements with
role="treeitem" that do not have an accessible name.
Rule Description
Aria treeitem elements must have discernible text that clearly describes the destination, purpose, function, or action for screen reader users.
The Algorithm (in simple terms)
Checks all elements with role="treeitem" to ensure that they have
a discernable, accessible name.
Resources
Deque University Course Pages (subscription required)
No related course information available.
Was this information helpful?
You have already given your feedback, thank you..
Your response was as follows:
Was this information helpful?
Date/Time feedback was submitted:
Date/Time feedback was submitted: