Checkbox

Элемент управления, позволяющий пользователю переключаться между состояниями «отмечено» и «не отмечено».

Принять условия использования

import { Checkbox } from "@/components/ui/checkbox";
import { Label } from "@/components/ui/label";

export default function Particle() {
  return (
    <Label>
      <Checkbox />
      Принять условия использования
    </Label>
  );
}

Установка


pnpm dlx shadcn@latest add @oracul/checkbox

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

import { Checkbox } from "@/components/ui/checkbox"

<Checkbox />

API

Checkbox

Стилизованная обёртка над Checkbox.Root из Base UI. Включает встроенный индикатор с иконками галочки и неопределённого состояния.

Примеры

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

Отключённый

Принять условия использования

import { Checkbox } from "@/components/ui/checkbox";
import { Label } from "@/components/ui/label";

export default function Particle() {
  return (
    <Label>
      <Checkbox defaultChecked disabled />
      Принять условия использования
    </Label>
  );
}

С описанием

Принимаю условия использования

Устанавливая этот флажок, вы соглашаетесь с условиями использования.

import { useId } from "react";
import { Checkbox } from "@/components/ui/checkbox";
import { Label } from "@/components/ui/label";

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

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

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

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

Уведомления можно включить или отключить в любой момент.

import { Checkbox } from "@/components/ui/checkbox";
import { Label } from "@/components/ui/label";

export default function Particle() {
  return (
    <Label className="flex items-start gap-2 rounded-lg border p-3 hover:bg-accent/50 has-data-checked:border-primary/48 has-data-checked:bg-accent/50">
      <Checkbox defaultChecked />
      <div className="flex flex-col gap-1">
        <p>Включить уведомления</p>
        <p className="text-muted-foreground text-xs">
          Уведомления можно включить или отключить в любой момент.
        </p>
      </div>
    </Label>
  );
}

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

Field предоставляет примитивы доступной маркировки и валидации для элементов управления формы. Используйте его вместе с Form для отправки значений.

"use client";

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

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);
    const accepted = formData.get("terms");
    alert(`Условия: ${accepted}`);
  };
  return (
    <Form className="flex w-auto flex-col gap-4" onSubmit={onSubmit}>
      <Field name="terms">
        <FieldLabel>
          <Checkbox defaultChecked value="yes" />
          Принимаю условия использования
        </FieldLabel>
      </Field>
      <Button loading={loading} type="submit">
        Отправить
      </Button>
    </Form>
  );
}

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

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