Accessibility limitations in accordion patterns

6/10 Medium

The new accordion pattern using grouped <details> elements has unresolved accessibility limitations. Using <details> elements doesn't preserve proper semantic heading hierarchy (e.g., in FAQ sections where headers would normally be <h2>), and the one-open-at-a-time behavior can cause unintended closures and horizontal scroll issues.

HTMLWeb Accessibility
Category
architecture
Workaround
partial
Stage
build
Freshness
emerging
Scope
language
Upstream
open

Sources

Collection History

Query: “What are the most common pain points with HTML for developers in 2025?”4/5/2026

A group of details elements can behave like an accordion, among other improvements, but still have accessibility limitations... there are still potential accessibility issues. Like imagine using this for a FAQ section where each question would normally be a header... which is a 'button', so that's not great.

Created: 4/5/2026Updated: 4/5/2026