| name | web-a11y-web-components |
| description | Applies accessibility guidance to custom elements and Shadow DOM, including progressive enhancement, slots, focus delegation, ElementInternals, ARIA limitations, and testing gaps. Use when building or auditing web components and design-system primitives. |
Web A11y Web Components
Rules
- Make accessible usage the easiest component API.
- Prefer progressive enhancement and useful light DOM fallback.
- Keep semantic reading order correct with slots and DOM order.
- Avoid brittle cross-root ARIA assumptions.
- Validate required labels, titles, and relationships at runtime where useful.
- Test manually because scanners vary in Shadow DOM coverage.
Checklist
Web component checklist
- [ ] Component has usable fallback or failure mode
- [ ] Slot order supports semantic reading order
- [ ] Required accessibility inputs are documented and enforced
- [ ] Focus delegation behavior is intentional
- [ ] ARIA relationships do not depend on unsupported cross-root references
- [ ] Automation is paired with keyboard and screen reader smoke checks
Output
Document component contract, Shadow DOM constraints, focus behavior, and manual verification notes.
