Pular para o conteúdo principal

Switch

Versões do DSV3
Papel (role)switch
Elemento HTML<input type="checkbox" role="switch"> com <label>
Classe / componentebr-switch
OrigemVeio 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}

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​

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​

TeclaO que faz
EspaçoLiga ou desliga
EnterLiga ou desliga (opcional no padrão)
Tab / Shift+TabMove o foco
Fonte: curadoria (WAI-ARIA APG).

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​

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.