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

سوییچ

برای روشن و خاموش کردن تنظیمی که بلافاصله اعمال می‌شود.

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

پایه

در راست‌به‌چپ، دستگیرهٔ سوییچ در حالت روشن به سمت چپ می‌رود؛ این رفتار خودکار است.

<Switch label="اعلان‌های ایمیلی" description="خلاصهٔ هفتگی فعالیت‌ها" defaultChecked />
<Switch label="حالت تعطیلات" />

اندازه‌ها و حالت‌ها

<Switch label="کوچک" size="sm" defaultChecked />
<Switch label="متوسط" defaultChecked />
<Switch label="بزرگ" size="lg" defaultChecked />
<Switch label="غیرفعال" disabled />

سوییچ یا چک‌باکس؟

  • سوییچ: تغییر فوراً اعمال می‌شود، مثل روشن کردن اعلان‌ها.
  • چک‌باکس: انتخاب پس از ارسال فرم اعمال می‌شود، مثل پذیرفتن قوانین.

ویژگی‌ها

نامنوعپیش‌فرضتوضیح
labelReactNode—برچسب کنار سوییچ
descriptionReactNode—توضیح زیر برچسب
size"sm" | "md" | "lg""md"اندازه
invalidbooleanfalseحالت خطا

متغیرهای CSS

متغیرپیش‌فرضکاربرد
--k-switch-width2.25remعرض
--k-switch-height1.25remارتفاع
--k-switch-track-onvar(--k-bg-brand)رنگ مسیر در حالت روشن
--k-switch-track-offvar(--k-border-input)رنگ مسیر در حالت خاموش
--k-switch-thumb#fffرنگ دستگیره

دسترس‌پذیری

  • روی <input type="checkbox" role="switch"> ساخته شده؛ صفحه‌خوان آن را «سوییچ، روشن» یا «خاموش» اعلام می‌کند.
  • مسیر خاموش کنتراست حداقل ۳ به ۱ با پس‌زمینه دارد.