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

الزر العائم

احصل على Ritla UI

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

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add fab

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

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

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

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

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

الاستخدام

fab.tsx
import { Fab } from "@/components/ui/fab";<Fab label="New transaction" className="fixed bottom-space-24 end-space-24" onClick={create} />

أمثلة

الأحجام

sm ‏56 (الافتراضي) وmd ‏80 وlg ‏96 بكسل. extended يُظهر النص بجانب الأيقونة؛ دونه يصبح label اسم الزر لقارئات الشاشة.

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

الحالات

المرور يرفعه بظل أكبر، والضغط يغمق لونه، والتركيز يضيف الحلقة ويبقي الظل. disabled موجود، لكن إن لم يكن الإجراء متاحًا فالأفضل ألا تُظهر الزر.

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

قائمة الإجراءات السريعة

FabMenu يفتح من 3 إلى 6 إجراءات مكدّسة فوق الزر عند نهاية السطر، ويتحول الزر إلى زر إغلاق (X). اضغطه، أو انتقل إليه بـTab واضغط Enter.

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

مرجع الخصائص

Fab

أي خاصية أخرى من Base UI Button تمر كما هي (onClick…).

الخاصيةالنوعالافتراضيالوصف
labelstringلا يوجدمطلوب. خاصية Label: النص الظاهر مع extended، والاسم لقارئات الشاشة دونه.
extendedbooleanfalseخاصية Extended FAB.
iconIconComponentPlusIconIcon leading. الأيقونات الاتجاهية تنعكس في العربية.
size"sm" | "md" | "lg""sm"خاصية Size: ‏56 و80 و96 بكسل.
disabledbooleanfalseخاصية State = Disabled. الأفضل إخفاء الزر حين لا يكون إجراؤه متاحًا.
renderReactElementلا يوجدرابط بشكل الزر العائم، يحتفظ بدلالته.
classNamestringلا يوجدالموضع: fixed bottom-space-24 end-space-24 للزاوية السفلية عند نهاية السطر.

FabMenu, FabMenuItem

الخاصيةالنوعالافتراضيالوصف
labelstringلا يوجدمطلوب. اسم الزر الذي يفتح القائمة («إجراءات سريعة»)، ويبقى نفسه وهي مفتوحة.
iconIconComponentPlusIconأيقونة الزر وهو مغلق؛ تصبح X عند الفتح.
open / defaultOpen / onOpenChangeboolean / (open) => voidلا يوجدحالة الفتح.
classNamestringلا يوجدالموضع، كما في Fab.
FabMenuItem: children, icon, onClickReactNode, IconComponent, (event) => voidلا يوجدنص الإجراء وأيقونته وما ينفّذه؛ تُغلق القائمة بعده.

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

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

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

المفتاحما يفعله
Tabيصل إلى الزر العائم كأي زر؛ مكانه في ترتيب التركيز حيث يقع في الكود.
EnterSpaceينفّذ الإجراء، أو يفتح القائمة ويركّز أول إجراء.
ArrowDownArrowUpفي القائمة: ينتقل بين الإجراءات.
Escapeيغلق القائمة ويعيد التركيز إلى الزر.

ARIA

  • الزر العائم بأيقونة فقط يأخذ label اسمًا؛ الموسّع يُسمّى بنصه.
  • زر القائمة يحمل aria-haspopup="menu" وaria-expanded، ويبقى اسمه نفسه حين يصبح X، فلا يتغير ما يُعلن.
  • زر عائم ثابت يغطي المحتوى: اترك مساحة أسفل الصفحة بقدر الزر ومسافته كي لا يخفي آخر عنصر.

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

ينعكس

  • الموضع منطقي: end-space-24 يضع الزر أسفل اليسار في العربية.
  • إجراءات القائمة تصطف عند نهاية السطر، أي على اليسار فوق الزر في العربية، والأيقونة قبل النص من جهة اليمين.

لا ينعكس

  • أيقونات Plus وX والقلم لا تنعكس؛ الظل عمودي فقط.
الأرقام
لا أرقام في الزر عادةً؛ إن أضفت عددًا إلى نص إجراء فنسّقه بـformatNumber.
الخط العربي
النص body-16 وbody-18 وbody-20 بوزن Semibold حسب الحجم، والارتفاع ثابت يتسع للعربية.
النص ثنائي الاتجاه
اسم لاتيني في نهاية إجراء عربي («مسح رمز QR») يُعرض صحيحًا؛ في وسطه ضعه في <bdi>.

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

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

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