checkbox-group
| Versões do DS | V4 |
| Papel (role) | group (fieldset/legend) |
| Elemento HTML | <fieldset><legend> com vários <input type="checkbox"> |
| Classe / componente | — |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Navega para o próximo Checkbox ou grupo |
| Shift+Tab | Navega para o Checkbox ou grupo anterior |
| Espaço | Marca/desmarca o Checkbox focado |
| Setas (↑/↓) | Navega entre Checkboxes no mesmo grupo (se agrupados verticalmente) |
| Setas (←/→) | Navega entre Checkboxes no mesmo grupo (se agrupados horizontalmente) |
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
- DS gov.br V4 · next-ds — Checkbox Group, acessibilidade
- W3C WAI-ARIA APG · WAI-ARIA APG — Checkbox Pattern
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.7 (agrupar campos de formulário)
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.