زر التبديل
زر بحالتين يبقى مضغوطًا حتى يُضغط مرة أخرى، للتنسيق أو التصفية أو المفضلة. يغيّر شكل الشيء أو ما يظهر منه، ولا يحفظ إعدادًا.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add toggleويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/toggleالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Toggle } from "@/components/ui/toggle";import { TextBIcon } from "@phosphor-icons/react/ssr";<Toggle iconLeading={TextBIcon}>Bold</Toggle>أمثلة
الأنماط والمقاسات والحالات
variant شفاف (ghost) أو بإطار (outline)، وsize sm (٣٢ بكسل) أو md (٤٠ بكسل). المضغوط بخلفية العلامة الفاتحة ونص وأيقونة بلون العلامة، فلا تعتمد الحالة على اللون وحده. disabled يخفت النص والأيقونة.
أيقونة فقط
بلا نص، سمِّه بـaria-label (وأضف تلميحًا إن لزم). عدة أزرار مستقلة جنبًا إلى جنب؛ لاختيار واحد من عدة خيارات استخدم مجموعة أزرار التبديل. لا زر للمائل: العربية بلا خط مائل، والكلمة المائلة تبدو مشوّهة.
مرجع الخصائص
Toggle
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | النص (خاصية Show label). اتركه وأضف aria-label لزر بأيقونة فقط. |
pressed / defaultPressed | boolean | لا يوجد | خاصية Pressed. |
onPressedChange | (pressed: boolean) => void | لا يوجد | عند الضغط. |
variant | "ghost" | "outline" | "ghost" | خاصية Style. |
size | "sm" | "md" | "sm" | خاصية Size: ٣٢ أو ٤٠ بكسل، ومساحة لمس ٤٨ بكسل. |
iconLeading | IconComponent | لا يوجد | خاصية Icon، في بداية السطر. |
disabled | boolean | لا يوجد | State = Disabled. |
value | string | لا يوجد | قيمته داخل مجموعة أزرار التبديل. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Space | يضغطه أو يحرّره. |
| Enter | يضغطه أو يحرّره أيضًا. |
ARIA
- زر بـ
aria-pressed، فيقرأ قارئ الشاشة «مضغوط» أو «غير مضغوط». الاسم لا يتغير بتغيّر الحالة. - مساحة اللمس ٤٨ بكسل ارتفاعًا في المقاسين.
- لإعداد يُحفظ ويُطبَّق فورًا استخدم مفتاح التبديل.
ملاحظات العربية والاتجاه
ينعكس
- الأيقونة في بداية الزر (اليمين) والنص بعدها.
لا ينعكس
- أيقونات التنسيق (عريض، تسطير) والنجمة لا تنعكس. الأيقونات الاتجاهية تنعكس وحدها عبر
<Icon>.
- الأرقام
- لا أرقام في الزر نفسه؛ أي رقم في النص يتبع
numerals. - الخط العربي
- النص
label-14أوlabel-16بوزن Medium؛ الزر بارتفاع ثابت والنص العربي يبقى في سطر واحد.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.