UI

Switch

Interruptor liga/desliga para configurações que têm efeito imediato.

Instalação

npx shadcn@latest add @lenstech/switch

Uso

import { Switch } from "@/components/ui/switch"
<Switch defaultSelected>Receber avisos por WhatsApp</Switch>

isSelected, não checked

O estado é controlado com isSelected (ou defaultSelected) e onChange recebe um boolean: onChange={setAtivo}.

Exemplos

Com descrição

Avisamos quando um novo agendamento chegar.
Resumo semanal de atendimentos toda segunda-feira.
Pacientes podem marcar consultas pelo site.

Desabilitado

Controlado

Clientes podem fazer pedidos agora.

Quando usar

  • Use para preferências que valem na hora: notificações, loja aberta/fechada, agendamento online.
  • Não use em formulários que só valem após clicar em "Enviar" (aceite de termos, LGPD) — use Checkbox.
  • Não use para escolher entre mais de duas opções — use Radio Group.

API

Switch

Aceita todas as props do Switch do React Aria, mais:

Prop

Type

Composição

SwitchField, SwitchButton e SwitchIndicator são as peças usadas pelo Switch, para layouts próprios.

On this page