Button
| Versões do DS | V3 e V4 |
| Papel (role) | button |
| Elemento HTML | <button> |
| Classe / componente | br-button |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Enter | Ativa o Button |
| Espaço | Ativa o Button |
| Tab | Navega para o item seguinte |
| Shift+Tab | Navega para o item anterior |
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
- DS gov.br V4 · next-ds — Button, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Button (acessibilidade no código)
- W3C WAI-ARIA APG · WAI-ARIA APG — Button Pattern
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.