تاگل (Toggle)

معرفی

کامپوننت Toggle یک دکمه تغییر وضعیت است.

چه زمانی استفاده نکنیم:

• برای تنظیمات روشن/خاموش با اثر فوری — از Switch استفاده کنید
• برای انتخاب یکی از چند گزینه exclusive — از RadioGroup استفاده کنید
• برای view mode selection (لیست/گرید) — از ViewToggle استفاده کنید

استفاده

import { Toggle } from '@parto-system-design/ui'
import { Icons } from '@parto-system-design/ui'

export default function MyComponent() {
  return (
    <Toggle aria-label="ضخیم">
      <Icons.bold className="h-4 w-4" />
    </Toggle>
  )
}

انواع

<Toggle variant="default">پیش‌فرض</Toggle>
<Toggle variant="outline">حاشیه‌دار</Toggle>

Props

دسترسی‌پذیری

• برای Toggle‌هایی که فقط آیکون دارند، aria-label الزامی است
• وضعیت فشرده شدن با aria-pressed به screen reader اعلام می‌شود
• از صفحه‌کلید با Space یا Enter قابل فعال‌سازی است

راهنمای استفاده

کامپوننت‌های مرتبط

• Switch — برای تنظیمات روشن/خاموش
• ToggleGroup — برای گروهی از toggle های مرتبط
• ViewToggle — برای تغییر حالت نمایش