انتقل إلى المحتوى

زر التبديل

احصل على Ritla UI

زر بحالتين يبقى مضغوطًا حتى يُضغط مرة أخرى، للتنسيق أو التصفية أو المفضلة. يغيّر شكل الشيء أو ما يظهر منه، ولا يحفظ إعدادًا.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

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

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add toggle

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/toggle

  2. الاعتماديات التي يضيفها

    @base-ui/react@phosphor-icons/react

  3. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

toggle.tsx
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 يخفت النص والأيقونة.

إنجليزيمعكوسعربي
← RTL

أيقونة فقط

بلا نص، سمِّه بـaria-label (وأضف تلميحًا إن لزم). عدة أزرار مستقلة جنبًا إلى جنب؛ لاختيار واحد من عدة خيارات استخدم مجموعة أزرار التبديل. لا زر للمائل: العربية بلا خط مائل، والكلمة المائلة تبدو مشوّهة.

إنجليزيمعكوسعربي
← RTL

مرجع الخصائص

Toggle

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدالنص (خاصية Show label). اتركه وأضف aria-label لزر بأيقونة فقط.
pressed / defaultPressedbooleanلا يوجدخاصية Pressed.
onPressedChange(pressed: boolean) => voidلا يوجدعند الضغط.
variant"ghost" | "outline""ghost"خاصية Style.
size"sm" | "md""sm"خاصية Size: ‏٣٢ أو ٤٠ بكسل، ومساحة لمس ٤٨ بكسل.
iconLeadingIconComponentلا يوجدخاصية Icon، في بداية السطر.
disabledbooleanلا يوجدState = Disabled.
valuestringلا يوجدقيمته داخل مجموعة أزرار التبديل.

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

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

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

المفتاحما يفعله
Spaceيضغطه أو يحرّره.
Enterيضغطه أو يحرّره أيضًا.

ARIA

  • زر بـaria-pressed، فيقرأ قارئ الشاشة «مضغوط» أو «غير مضغوط». الاسم لا يتغير بتغيّر الحالة.
  • مساحة اللمس ٤٨ بكسل ارتفاعًا في المقاسين.
  • لإعداد يُحفظ ويُطبَّق فورًا استخدم مفتاح التبديل.

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

ينعكس

  • الأيقونة في بداية الزر (اليمين) والنص بعدها.

لا ينعكس

  • أيقونات التنسيق (عريض، تسطير) والنجمة لا تنعكس. الأيقونات الاتجاهية تنعكس وحدها عبر <Icon>.
الأرقام
لا أرقام في الزر نفسه؛ أي رقم في النص يتبع numerals.
الخط العربي
النص label-14 أو label-16 بوزن Medium؛ الزر بارتفاع ثابت والنص العربي يبقى في سطر واحد.

الفحوص التي يجتازها

فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.

  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة