Switch
| Versões do DS | V3 |
| Papel (role) | switch |
| Elemento HTML | <input type="checkbox" role="switch"> com <label> |
| Classe / componente | br-switch |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds.
Nome acessível
O rótulo ligado ao input, descrevendo o que liga/desliga (sem repetir "ligado" no texto). Exemplo: Receber avisos por e-mail.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, interruptor{estado}
Estados
Ligado / desligado
- No código:
aria-checked="true|false" (ou checked nativo com role="switch") - Acrescenta ao anúncio: ligado / desligado
Desabilitado
- No código:
disabled - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Espaço | Liga ou desliga |
| Enter | Liga ou desliga (opcional no padrão) |
| Tab / Shift+Tab | Move o foco |
Para o desenvolvimento
br-switch (V3). O core usa <input type="checkbox" role="switch"> dentro de um contêiner role="presentation". O efeito deve ser imediato; se precisar de botão "Salvar", prefira checkbox.
Fontes
- DS gov.br V3 · @govbr-ds/core — Switch (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Switch 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.