رفتن به محتوای اصلی

چک‌باکس

برای انتخاب یک یا چند گزینه، یا تأیید یک مورد. روی input بومی ساخته شده است.

import { Checkbox } from "@kashi-ui/react";

پایه

<Checkbox label="مرا به خاطر بسپار" defaultChecked />
<Checkbox label="خبرنامه" description="ماهی یک ایمیل، بدون تبلیغات." />

حالت‌ها

indeterminate برای «انتخاب همه» وقتی فقط بخشی از گزینه‌ها انتخاب شده‌اند.

<Checkbox label="انتخاب همه" indeterminate />
<Checkbox label="قوانین را می‌پذیرم" invalid />
<Checkbox label="غیرفعال" disabled />
<Checkbox label="بزرگ" size="lg" defaultChecked />

ویژگی‌ها

نامنوعپیش‌فرضتوضیح
labelReactNode—برچسب کنار چک‌باکس؛ کل برچسب قابل‌کلیک است
descriptionReactNode—توضیح زیر برچسب؛ با aria-describedby متصل می‌شود
indeterminatebooleanfalseحالت نیمه‌انتخاب
invalidbooleanfalseحالت خطا
size"md" | "lg""md"۱۸ یا ۲۰ پیکسل

متغیرهای CSS

متغیرپیش‌فرضکاربرد
--k-checkbox-size1.125remاندازه
--k-checkbox-radius0.3125rem × radius-factorگردی گوشه‌ها

دسترس‌پذیری

  • روی <input type="checkbox"> بومی ساخته شده؛ کلید Space، فرم‌ها و صفحه‌خوان‌ها بدون کد اضافه کار می‌کنند.
  • در حالت کنتراست بالای ویندوز، ظاهر بومی سیستم نمایش داده می‌شود.
  • برای گروه چک‌باکس‌ها از <fieldset> و <legend> استفاده کنید.