Biblioteca de componentes v1.10.0 GitHub

Checkbox

<x-ui.checkbox>

Caixa de marcação com rótulo, dica e erro, no mesmo desenho dos demais campos.

Aceite e opções

No máximo um e-mail por mês.

blade
<x-ui.checkbox name="aceite" label="Li e aceito a política de privacidade" required />
<x-ui.checkbox name="novidades" value="sim" label="Quero receber novidades" hint="No máximo um e-mail por mês." checked />
<x-ui.checkbox name="termos" id="termos-2024" label="Contrato de 2024" error="É preciso aceitar para continuar." />

Props

x-ui.checkbox

Prop Padrão Aceita
name null
id null
value '1'
label null
hint null
error null
checked false
required false

Personalizar

As três camadas estão explicadas em Começar aqui. Abaixo, o que este componente expõe a cada uma.

Ui::checkbox()

Partes

part() e replacePart() aceitam: base, label, control, text, hint e error.

Tokens que ele lê

Nenhum específico: ele usa só cor e espaçamento do Tailwind.

Por que é assim 2 notas
  • O id sai de name + value, então várias caixas do mesmo campo convivem sem uma roubar o clique da outra.
  • A cor vem de accent-primary, no controle nativo: sem SVG substituto, o estado marcado continua sendo o do sistema.