Pular para o conteúdo principal

Checkbox

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

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

Nome acessível​

O rótulo ligado por for/id ou por encapsulamento; descreve a opção que será marcada. Exemplo: Aceito os termos de uso.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, caixa de seleçã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​

Marcado​

  • No código: checked (nativo) ou aria-checked="true"
  • Acrescenta ao anúncio: marcado / não marcado

Indeterminado (pai de itens parciais)​

  • No código: indeterminate (JS) ou aria-checked="mixed"
  • Acrescenta ao anúncio: parcialmente marcado

Com erro​

  • No código: aria-invalid="true" e aria-describedby apontando para a mensagem
  • Acrescenta ao anúncio: inválido, {mensagem}

Desabilitado​

  • No código: disabled
  • Acrescenta ao anúncio: indisponível

Teclado​

TeclaO que faz
TabNavega para o item seguinte
Shift+TabNavega para o item anterior
EspaçoMarca/desmarca o Checkbox
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

br-checkbox (V3) / <br-checkbox> (V4). Use o <input> nativo; o desenho é só CSS. No core o aria-label pode ser passado ao input quando não há rótulo visível. Espaço alterna.

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.