z-uiDesign system
Componentes · shadcn

Switch

Liga e desliga uma configuração com efeito imediato. Para concordar com um termo, use Checkbox.

Configurações do envelope

Tamanhos e estados

Props

PropTipoPadrãoDescrição
checked / defaultCheckedboolean—Estado ligado, controlado ou inicial.
onCheckedChange(checked: boolean) => void—Chamado a cada troca.
size"sm" | "md" | "lg""md"Trilho de 36, 44 ou 52px de largura.
labelReactNode—Texto clicável à esquerda do controle.
descriptionReactNode—Explicação abaixo do rótulo.
disabledbooleanfalseBloqueia a troca.
<Switch checked={ordered} onCheckedChange={setOrdered} label="Assinatura em ordem" />