سوییچ
برای روشن و خاموش کردن تنظیمی که بلافاصله اعمال میشود.
import { Switch } from "@kashi-ui/react";
پایه
در راستبهچپ، دستگیرهٔ سوییچ در حالت روشن به سمت چپ میرود؛ این رفتار خودکار است.
<Switch label="اعلانهای ایمیلی" description="خلاصهٔ هفتگی فعالیتها" defaultChecked />
<Switch label="حالت تعطیلات" /><label class="k-check" for=":r0R0:">
<input type="checkbox" role="switch" id=":r0R0:" class="k-switch" aria-describedby=":r0R0:-desc" checked=""/><span class="k-check__text"><span class="k-check__label">اعلانهای ایمیلی</span><span class="k-check__description" id=":r0R0:-desc">خلاصهٔ هفتگی فعالیتها</span></span>
</label>
<label class="k-check" for=":r1R0:">
<input type="checkbox" role="switch" id=":r1R0:" class="k-switch"/><span class="k-check__text"><span class="k-check__label">حالت تعطیلات</span></span>
</label>اندازهها و حالتها
<Switch label="کوچک" size="sm" defaultChecked />
<Switch label="متوسط" defaultChecked />
<Switch label="بزرگ" size="lg" defaultChecked />
<Switch label="غیرفعال" disabled /><label class="k-check" for=":r2R0:">
<input type="checkbox" role="switch" id=":r2R0:" class="k-switch k-switch--sm" checked=""/><span class="k-check__text"><span class="k-check__label">کوچک</span></span>
</label>
<label class="k-check" for=":r3R0:">
<input type="checkbox" role="switch" id=":r3R0:" class="k-switch" checked=""/><span class="k-check__text"><span class="k-check__label">متوسط</span></span>
</label>
<label class="k-check" for=":r4R0:">
<input type="checkbox" role="switch" id=":r4R0:" class="k-switch k-switch--lg" checked=""/><span class="k-check__text"><span class="k-check__label">بزرگ</span></span>
</label>
<label class="k-check" for=":r5R0:">
<input type="checkbox" role="switch" id=":r5R0:" class="k-switch" disabled=""/><span class="k-check__text"><span class="k-check__label">غیرفعال</span></span>
</label>سوییچ یا چکباکس؟
- سوییچ: تغییر فوراً اعمال میشود، مثل روشن کردن اعلانها.
- چکباکس: انتخاب پس از ارسال فرم اعمال میشود، مثل پذیرفتن قوانین.
ویژگیها
| نام | نوع | پیشفرض | توضیح |
|---|---|---|---|
label | ReactNode | — | برچسب کنار سوییچ |
description | ReactNode | — | توضیح زیر برچسب |
size | "sm" | "md" | "lg" | "md" | اندازه |
invalid | boolean | false | حالت خطا |
متغیرهای CSS
| متغیر | پیشفرض | کاربرد |
|---|---|---|
--k-switch-width | 2.25rem | عرض |
--k-switch-height | 1.25rem | ارتفاع |
--k-switch-track-on | var(--k-bg-brand) | رنگ مسیر در حالت روشن |
--k-switch-track-off | var(--k-border-input) | رنگ مسیر در حالت خاموش |
--k-switch-thumb | #fff | رنگ دستگیره |
دسترسپذیری
- روی
<input type="checkbox" role="switch">ساخته شده؛ صفحهخوان آن را «سوییچ، روشن» یا «خاموش» اعلام میکند. - مسیر خاموش کنتراست حداقل ۳ به ۱ با پسزمینه دارد.