Web A11y Web Components

Rules

1. Make accessible usage the easiest component API.
2. Prefer progressive enhancement and useful light DOM fallback.
3. Keep semantic reading order correct with slots and DOM order.
4. Avoid brittle cross-root ARIA assumptions.
5. Validate required labels, titles, and relationships at runtime where useful.
6. Test manually because scanners vary in Shadow DOM coverage.

Checklist

Web component checklist