aria-text

Installation
SKILL.md

Avoid focusable descendants in role="text" elements

Using role="text" on a container forces screen readers to treat everything inside as a single string of text, which effectively hides any interactive elements from users who rely on assistive technology.

Quick Reference

  • Elements with role="text" should not contain interactive children (links, buttons)
  • Ensure role="text" only contains static text content
  • Prevent accessibility "black holes" where interactive items are hidden from screen readers

Check

Identify elements with role="text" and verify they do not contain any focusable elements like buttons, links, or inputs.

Fix

Remove role="text" from containers that have interactive children or move the interactive elements outside.

Explain

Installs
8
GitHub Stars
73.9K
First Seen
Jul 31, 2026
aria-text — thedaviddias/front-end-checklist