components
checkbox
Permite selecionar múltiplas opções independentes. Para opções mutuamente exclusivas, use radio button.
overview
variantes
Variante única.
estados
modifiers · api
| prop | tipo | default | descrição |
|---|---|---|---|
| type="checkbox" | attr | — | required |
| checked | attr | — | estado inicial |
| disabled | attr | — | desabilita |
| required | attr | — | obrigatório em form |
| indeterminate | prop JS | — | estado parcial (pai de checkboxes mistos) |
quando usar
use
não use
acessibilidade
- Sempre dentro de <label> ou com label associado por for/id
- accent-color: var(--ch-code) pra usar a cor brand
- Foco visível
- Estado checked anunciado por SR
código
<label class="checkbox-row">
<input type="checkbox"> concordo com os termos
</label>