البناء · جديد

بطاقة الإعداد

صف إعدادات يُشغَّل بمفتاح تبديل، بأيقونة في البداية وعنوان ونص داعم. الصف كله قابل للنقر.

المعاينة

المعكوسة هي المحتوى الإنجليزي نفسه من اليمين إلى اليسار، لتفصل خطأ الاتجاه عن خطأ الترجمة.

التثبيت

قريبًايُفتح التثبيت من السجل مع الإطلاق. حتى ذلك الحين، هذا هو الأمر الذي ستستخدمه.
npx shadcn@latest add @ritla/switch-card

الاستخدام

import { SwitchCard } from "@/components/ui/switch-card";
<SwitchCard leading={BellIcon} defaultChecked description="Transfers, card payments and logins">
  Push notifications
</SwitchCard>

أمثلة

المفتاح في البداية

leading="switch" يضع المفتاح في بداية الصف.

مرجع الخصائص

SwitchCard

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeخاصية Headline: اسم الإعداد.
overline / description / trailingTextReactNodeخصائص Overline وSupporting text وTrailing text.
leadingIconComponent | ReactNode | "switch"خاصية Leading type.
checked / defaultChecked / onCheckedChange…كما في Switch.
disabledbooleanState = Disabled.

إمكانية الوصول

لوحة المفاتيح

المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.

المفتاحما يفعله
Spaceيبدّل المفتاح؛ Tab ينتقل بين الصفوف.

ARIA

  • كل مفتاح role="switch" مسمّى بعنوان صفه ومرتبط بنصه الداعم.

ملاحظات العربية والاتجاه

ينعكس

  • الأيقونة في البداية (اليمين) والمفتاح في النهاية (اليسار)، كما يوصي Figma لقوائم الإعدادات.

لا ينعكس

  • الأيقونات غير الاتجاهية لا تنعكس.
الأرقام
الأرقام في النصوص تتبع numerals.
الخط العربي
العنوان body-16 بوزن Medium.

كل المكونات ›