پرتوپرتو

سوییچ (Switch)

کنترل تغییر وضعیت دوحالته

معرفی

کامپوننت Switch برای تغییر وضعیت بین دو حالت استفاده می‌شود.

استفاده

import { Switch } from '@parto-system-design/ui';
import { Label } from '@parto-system-design/ui';

export default function MyComponent() {
  return (
    <div className="flex items-center gap-2">
      <Switch id="airplane-mode" />
      <Label htmlFor="airplane-mode">حالت هواپیما</Label>
    </div>
  );
}

اندازه‌ها

کامپوننت Switch از سه اندازه پشتیبانی می‌کند:

<div className="flex items-center gap-4">
  <Switch size="small" />
  <Switch size="medium" />
  <Switch size="large" />
</div>

کوچک (Small)

<Switch size="small" />

ابعاد: ارتفاع ۱۶ پیکسل، عرض ۲۸ پیکسل

متوسط (Medium) - پیش‌فرض

<Switch size="medium" />
// یا
<Switch />

ابعاد: ارتفاع ۲۰ پیکسل، عرض ۳۴ پیکسل

بزرگ (Large)

<Switch size="large" />

ابعاد: ارتفاع ۲۴ پیکسل، عرض ۴۴ پیکسل

حالت غیرفعال

<Switch disabled />
<Switch disabled defaultChecked />

کنترل شده

const [checked, setChecked] = React.useState(false);

<Switch checked={checked} onCheckedChange={setChecked} />

Props

Prop

Type

ویژگی‌ها

  • انیمیشن نرم
  • پشتیبانی از حالت disabled
  • کاملاً قابل دسترس
  • سه اندازه مختلف

ملاحظات RTL

  • انیمیشن حرکت thumb در RTL به‌درستی معکوس می‌شود
  • از CSS variables برای کنترل جهت استفاده می‌شود