Magic Button
| Versões do DS | V3 |
| Papel (role) | button |
| Elemento HTML | <button> |
| Classe / componente | br-magicbutton |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds.
Nome acessível
Botão flutuante em geral só com ícone: aria-label com a ação é obrigatório. Exemplo: Adicionar.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, botão{estado}
Estados
Desabilitado
- No código:
disabled - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Enter | Ativa o controle em foco |
| Espaço | Ativa botões e alterna controles |
| Tab / Shift+Tab | Move o foco para o controle seguinte / anterior |
Para o desenvolvimento
br-magicbutton (V3). Regra do core: aria-label="descrição da ação" nos botões que tenham só ícone; ícone com aria-hidden="true". Posição fixa não pode cobrir conteúdo nem os controles em zoom de 200%.
Fontes
- DS gov.br V3 · @govbr-ds/core — Magic Button (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Button Pattern
- WCAG · WCAG 2.2 — 1.4.10 Reflow
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.