MenuChevron Down
Switch Interruptor - Docs - Artefact

Switch Interruptor

Forms
Detecção automática inteligente

Introdução

Um controle que permite ao usuário alternar entre os estados ativado e desativado.

Uso

import { Switch } from "../components/ui";

export default function MyPage() {
  return (
    <Switch
      defaultChecked={true}
      onCheckedChange={(details) => console.log(details.checked)}
      interactive
    >
      Enable Notifications
    </Switch>
  );
}

Construtor de páginas CMS

Este componente está disponível como um bloco switch no Construtor de páginas (content/pages/*.json):

{
  "type": "switch",
  "label": "Dark Mode",
  "checked": true,
  "colorPalette": "blue"
}

Propriedades

PropTypeDescription
childrenanyConteúdo do rótulo renderizado ao lado do switch.
classstringClasses CSS personalizadas.
checkedbooleanSe o switch está ativado (controlado).
defaultCheckedbooleanO estado inicial ativado (não controlado).
disabledbooleanSe o switch está desabilitado.
onCheckedChange(details: { checked: boolean }) => voidCallback acionado quando o estado ativado muda.

| size | `"sm" \ | "md" \ | "lg"` | O tamanho do switch. |

| interactive | boolean | Força a hidratação como island. |