Accordion
| Versões do DS | V3 |
| Papel (role) | button (cabeçalho) controlando uma região |
| Elemento HTML | <h3><button aria-expanded aria-controls> + <div role="region"> |
| Classe / componente | br-accordion |
| Origem | A documentação do DS não cobre o essencial: completado pela curadoria com o padrão do W3C (WAI-ARIA APG) e o eMAG. |
Documentação oficial: gov.br/ds.
Nome acessível
O texto do cabeçalho do item. A região exibida pode receber o nome do cabeçalho (aria-labelledby). Exemplo: Quem pode solicitar?.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, botão{estado}
Estados
Expandido / recolhido
- No código:
aria-expanded="true|false" e aria-controls apontando para o painel - Acrescenta ao anúncio: expandido / recolhido
Desabilitado
- No código:
aria-disabled="true" - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Enter ou Espaço | Expande ou recolhe o painel do cabeçalho em foco |
| Tab / Shift+Tab | Move o foco entre os cabeçalhos e o conteúdo interativo |
Para o desenvolvimento
br-accordion (V3). O core 3.x marca o componente como obsoleto/depreciado; para conteúdo expansível novo, avalie o util collapse e o padrão correspondente. No código, o botão aponta o painel com aria-controls.
Fontes
- DS gov.br V3 · @govbr-ds/core — Accordion (marcado obsoleto) (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Accordion Pattern
- WCAG · WCAG 2.2 — 4.1.2 Nome, função, valor
Comentários e evolução
Viu algo a corrigir ou completar nesta especificação? Comente abaixo dizendo qual parte, o que mudar e a fonte (WCAG, eMAG, WAI-ARIA APG, documentação do DS gov.br ou teste com leitor de tela). É preciso uma conta no GitHub. As sugestões aceitas entram na base e aparecem nas Novidades.