Pular para o conteúdo principal

Accordion

Versões do DSV3
Papel (role)button (cabeçalho) controlando uma região
Elemento HTML<h3><button aria-expanded aria-controls> + <div role="region">
Classe / componentebr-accordion
OrigemA 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}

Comportamento esperado, não a fala exata: NVDA, JAWS, VoiceOver e TalkBack variam. No plugin, cada elemento tem um campo para o resultado do teste com leitor de tela real.

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​

TeclaO que faz
Enter ou EspaçoExpande ou recolhe o painel do cabeçalho em foco
Tab / Shift+TabMove o foco entre os cabeçalhos e o conteúdo interativo
Fonte: curadoria (WAI-ARIA APG).

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​

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.