Switch

Элемент управления, который показывает, включена настройка или выключена.

Рассылки о новинках

import { Label } from "@/components/ui/label";
import { Switch } from "@/components/ui/switch";

export default function Particle() {
  return (
    <Label>
      <Switch />
      Рассылки о новинках
    </Label>
  );
}

Установка


pnpm dlx shadcn@latest add @oracul/switch

Использование

import { Switch } from "@/components/ui/switch"

<Switch />

API

Switch

Стилизованная обёртка над Switch.Root из Base UI со встроенным ползунком. Размер задаётся через CSS-переменную --thumb-size.

Примеры

Для доступной разметки меток и валидации предпочтительно оборачивать чекбоксы компонентом Field. См. связанный пример: Поле с переключателем.

Отключённое состояние

Рассылки о новинках

import { Label } from "@/components/ui/label";
import { Switch } from "@/components/ui/switch";

export default function Particle() {
  return (
    <Label>
      <Switch disabled />
      Рассылки о новинках
    </Label>
  );
}

С описанием

Рассылки о новинках

Включая рассылки, вы соглашаетесь получать письма от нас.

import { useId } from "react";
import { Label } from "@/components/ui/label";
import { Switch } from "@/components/ui/switch";

export default function Particle() {
  const id = useId();

  return (
    <div className="flex items-start gap-2">
      <Switch defaultChecked id={id} />
      <div className="flex flex-col gap-1">
        <Label htmlFor={id}>Рассылки о новинках</Label>
        <p className="text-muted-foreground text-xs">
          Включая рассылки, вы соглашаетесь получать письма от нас.
        </p>
      </div>
    </div>
  );
}

Размер переключателя задаётся CSS-переменной --thumb-size. По умолчанию переключатель использует адаптивные размеры с классами [--thumb-size:--spacing(5)] sm:[--thumb-size:--spacing(4)], что делает его немного крупнее на мобильных устройствах (как и другие интерактивные элементы).

Вы можете настроить размер, переопределив эти классы с CSS-переменной на компоненте. Значение --thumb-size можно выразить через:

Шкалу отступов: --spacing(3), --spacing(4), --spacing(5) и т. д.
Фиксированные единицы: 1rem, 16px и т. д.

Стиль карточки

Включить уведомления

Вы можете включать и отключать уведомления в любой момент.

import { useId } from "react";
import { Label } from "@/components/ui/label";
import { Switch } from "@/components/ui/switch";

export default function Particle() {
  const id = useId();

  return (
    <Label
      className="flex items-center gap-6 rounded-lg border p-3 hover:bg-accent/50 has-data-checked:border-primary/48 has-data-checked:bg-accent/50"
      htmlFor={id}
    >
      <div className="flex flex-col gap-1">
        <p>Включить уведомления</p>
        <p className="text-muted-foreground text-xs">
          Вы можете включать и отключать уведомления в любой момент.
        </p>
      </div>
      <Switch
        className="[--thumb-size:--spacing(4)] sm:[--thumb-size:--spacing(3)]"
        defaultChecked
        id={id}
      />
    </Label>
  );
}

Интеграция с формой

"use client";

import type { FormEvent } from "react";
import { useState } from "react";
import { Button } from "@/components/ui/button";
import { Field, FieldLabel } from "@/components/ui/field";
import { Form } from "@/components/ui/form";
import { Switch } from "@/components/ui/switch";

export default function Particle() {
  const [loading, setLoading] = useState(false);

  const onSubmit = async (e: FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    const formData = new FormData(e.currentTarget);
    setLoading(true);
    await new Promise((r) => setTimeout(r, 800));
    setLoading(false);
    console.log(formData.get("marketing"));

    const enabled = formData.get("marketing");
    alert(`Рассылки о новинках: ${enabled}`);
  };

  return (
    <Form className="flex flex-col gap-4" onSubmit={onSubmit}>
      <Field name="marketing">
        <FieldLabel>
          <Switch defaultChecked name="marketing" />
          Включить рассылки о новинках
        </FieldLabel>
      </Field>
      <Button loading={loading} type="submit">
        Отправить
      </Button>
    </Form>
  );
}

На этой странице

Установка Использование API Switch Примеры Отключённое состояние С описанием Настройка размера Стиль карточки Интеграция с формой