role=text should have no focusable descendants
What is the problem?
The aria-text rule ensures that the role="text" attribute is not used on elements that contain focusable children.
Impacted Groups
Why is this important?
When role="text" is used on an element with focusable children, screen readers may not announce the focusable elements correctly. This can make it difficult for users to navigate and interact with the content, hindering their ability to access the information they need.
How to solve this issue
To fix this issue, avoid using role="text" on elements that contain focusable descendants. Instead, use more appropriate roles or remove the role attribute altogether. By following this rule, developers can ensure that screen reader users can easily navigate and interact with the content.
Rule Information
Rule ID
aria-text
Severity
Manual Review Required
Rule Group
Best Practices Rules
Guidelines
- Best Practice
Customise Guidance
You can customise each accessibility rule in SiteAlly with your own guidance, instructions and even links to your own organisation specific documentation.
Enable your website editors to resolve issues quickly with SiteAlly.
Ready to make your website accessible?
SiteAlly provides automated accessibility monitoring, detailed reports, and step-by-step guidance to help you achieve and maintain compliance.