TaavUI Lab
Form Control

TaavCheckbox

چک‌باکس native با label/description استاندارد — برای consent، multi-select و bulk actions.

import { TaavCheckbox } from "@repo/ui/taav/forms";

فقط از props رسمی TaavUI استفاده کنید. unsafeClassName و escape hatchهای مشابه فقط برای موارد نادر هستند و نباید در مثال‌های عادی دیده شوند.

استفاده پایه

RTL Preview
<TaavCheckbox label="قوانین را می‌پذیرم" defaultChecked />

Sizes & tones

پیش‌نمایش

States

پیش‌نمایش

Props

Propنوعپیش‌فرضتوضیح
size'sm' | 'md' | 'lg'mdاندازه control
tone'brand' | 'neutral' | 'success' | 'warning' | 'danger'brandرنگ checked
indeterminatebooleanfalseحالت نیمه‌انتخاب
invalidbooleanfalseحالت خطا
label / descriptionReactNodeچیدمان استاندارد label

Design Specs

Size mdvar(--taav-control-size-md)
Radiusvar(--taav-checkbox-radius)
Focusvar(--taav-control-focus-ring)

دسترس‌پذیری

راهنمای استفاده در DastRanj / VahedYek

  • input native + label مرتبط
  • indeterminate برای select-all

Do / Don't

انجام دهید

  • از label/description داخلی استفاده کنید

انجام ندهید

  • ردیف checkbox سفارشی در صفحات app نسازید