Pular para o conteúdo principal

Button

Versões do DSV3 e V4
Papel (role)button
Elemento HTML<button>
Classe / componentebr-button
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds · next-ds.

Nome acessível​

O texto do rótulo. Botão só com ícone (circular) precisa de aria-label que descreva a ação. Exemplo: Entrar com gov.br.

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​

Desabilitado​

  • No código: disabled (ou aria-disabled="true" se precisar continuar focável)
  • Acrescenta ao anúncio: indisponível

Alternado (liga/desliga)​

  • No código: aria-pressed="true|false"
  • Acrescenta ao anúncio: pressionado / não pressionado

Teclado​

TeclaO que faz
EnterAtiva o Button
EspaçoAtiva o Button
TabNavega para o item seguinte
Shift+TabNavega para o item anterior
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

Use <button class="br-button"> (V3) ou <br-button> (V4). Ícone decorativo com aria-hidden="true". Botão circular: aria-label obrigatório.

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.