Switch
Controle que permite ao usuário alternar entre os estados ligado e desligado.
Exemplos
Regular
Desabilitado
Com ícones personalizados
Com descrição
API
Switch
| Propriedade | Tipo | Padrão | Descrição |
|---|---|---|---|
| asChild | boolean | false | Troca o elemento renderizado por padrão pelo que for passado como filho, mesclando props e comportamento. |
| defaultChecked | boolean | - | Estado do switch na primeira renderização. Use quando não precisar controlar o estado. |
| checked | boolean | - | Estado controlado do switch. Deve ser usado junto com onCheckedChange. |
| onCheckedChange | (checked: boolean) => void | - | Função chamada quando o estado do switch muda. |
| disabled | boolean | - | Quando true, impede o usuário de interagir com o switch. |
| required | boolean | - | Quando true, indica que o usuário precisa ativar o switch antes de enviar o formulário que o contém. |
| name | string | - | Nome do switch. É enviado com o formulário que o contém como parte de um par nome/valor. |
| value | string | "on" | Valor enviado como dado quando o switch é submetido com um name. |
| variant | "regular" | "regular" | Estilo visual do switch. |
| size | "sm" | "md" | "lg" | "md" | Tamanho do switch. |
| checkedIcon | React.ReactNode | - | Ícone personalizado exibido quando o switch está ativado. |
| uncheckedIcon | React.ReactNode | - | Ícone personalizado exibido quando o switch está desativado. |
| Atributo data | Valores |
|---|---|
| [data-state] | "checked" | "unchecked" |
| [data-disabled] | Presente quando desabilitado |