Pular para o conteúdo principal

checkbox-group

Versões do DSV4
Papel (role)group (fieldset/legend)
Elemento HTML<fieldset><legend> com vários <input type="checkbox">
Classe / componente—
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: next-ds.

Nome acessível​

A legenda do grupo ("Selecione suas preferências"); cada checkbox tem o próprio rótulo. Exemplo: Selecione suas preferências.

O que é anunciado​

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

Com erro​

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

Obrigatório​

  • No código: required (ou aria-required="true")
  • Acrescenta ao anúncio: obrigatório

Desabilitado​

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

Teclado​

TeclaO que faz
TabNavega para o próximo Checkbox ou grupo
Shift+TabNavega para o Checkbox ou grupo anterior
EspaçoMarca/desmarca o Checkbox focado
Setas (↑/↓)Navega entre Checkboxes no mesmo grupo (se agrupados verticalmente)
Setas (←/→)Navega entre Checkboxes no mesmo grupo (se agrupados horizontalmente)
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

<br-checkbox-group> (V4 apenas). Use fieldset/legend ou role="group" com aria-labelledby. O erro do grupo fica ligado por aria-describedby e aparece também em texto, não só na cor.

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.