چکباکس
برای انتخاب یک یا چند گزینه، یا تأیید یک مورد. روی input بومی ساخته شده است.
import { Checkbox } from "@kashi-ui/react";
پایه
<Checkbox label="مرا به خاطر بسپار" defaultChecked />
<Checkbox label="خبرنامه" description="ماهی یک ایمیل، بدون تبلیغات." /><label class="k-check" for=":r0R0:">
<input type="checkbox" id=":r0R0:" class="k-checkbox" checked=""/><span class="k-check__text"><span class="k-check__label">مرا به خاطر بسپار</span></span>
</label>
<label class="k-check" for=":r1R0:">
<input type="checkbox" id=":r1R0:" class="k-checkbox" aria-describedby=":r1R0:-desc"/><span class="k-check__text"><span class="k-check__label">خبرنامه</span><span class="k-check__description" id=":r1R0:-desc">ماهی یک ایمیل، بدون تبلیغات.</span></span>
</label>حالتها
indeterminate برای «انتخاب همه» وقتی فقط بخشی از گزینهها انتخاب شدهاند.
<Checkbox label="انتخاب همه" indeterminate />
<Checkbox label="قوانین را میپذیرم" invalid />
<Checkbox label="غیرفعال" disabled />
<Checkbox label="بزرگ" size="lg" defaultChecked /><label class="k-check" for=":r2R0:">
<input type="checkbox" id=":r2R0:" class="k-checkbox" data-indeterminate="true"/><span class="k-check__text"><span class="k-check__label">انتخاب همه</span></span>
</label>
<label class="k-check" for=":r3R0:">
<input type="checkbox" id=":r3R0:" class="k-checkbox" aria-invalid="true"/><span class="k-check__text"><span class="k-check__label">قوانین را میپذیرم</span></span>
</label>
<label class="k-check" for=":r4R0:">
<input type="checkbox" id=":r4R0:" class="k-checkbox" disabled=""/><span class="k-check__text"><span class="k-check__label">غیرفعال</span></span>
</label>
<label class="k-check" for=":r5R0:">
<input type="checkbox" id=":r5R0:" class="k-checkbox k-checkbox--lg" checked=""/><span class="k-check__text"><span class="k-check__label">بزرگ</span></span>
</label>ویژگیها
| نام | نوع | پیشفرض | توضیح |
|---|---|---|---|
label | ReactNode | — | برچسب کنار چکباکس؛ کل برچسب قابلکلیک است |
description | ReactNode | — | توضیح زیر برچسب؛ با aria-describedby متصل میشود |
indeterminate | boolean | false | حالت نیمهانتخاب |
invalid | boolean | false | حالت خطا |
size | "md" | "lg" | "md" | ۱۸ یا ۲۰ پیکسل |
متغیرهای CSS
| متغیر | پیشفرض | کاربرد |
|---|---|---|
--k-checkbox-size | 1.125rem | اندازه |
--k-checkbox-radius | 0.3125rem × radius-factor | گردی گوشهها |
دسترسپذیری
- روی
<input type="checkbox">بومی ساخته شده؛ کلید Space، فرمها و صفحهخوانها بدون کد اضافه کار میکنند. - در حالت کنتراست بالای ویندوز، ظاهر بومی سیستم نمایش داده میشود.
- برای گروه چکباکسها از
<fieldset>و<legend>استفاده کنید.