Checkbox
| Versões do DS | V3 e V4 |
| Papel (role) | checkbox |
| Elemento HTML | <input type="checkbox"> com <label> |
| Classe / componente | br-checkbox |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Navega para o item seguinte |
| Shift+Tab | Navega para o item anterior |
| Espaço | Marca/desmarca o Checkbox |
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
- DS gov.br V4 · next-ds — Checkbox, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Checkbox (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Checkbox Pattern
- eMAG 3.1 · eMAG 3.1 — Recomendação 6.2 (associar etiquetas aos seus campos)
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.