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

النافذة المنبثقة

احصل على Ritla UI

مساحة صغيرة لمهمة واحدة سريعة، تنفتح بجانب الزر الذي فتحها.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add popover

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

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

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

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

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

الاستخدام

popover.tsx
import { Button } from "@/components/ui/button";import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";<Popover>  <PopoverTrigger render={<Button variant="outline" />}>Share</PopoverTrigger>  <PopoverContent title="Share this report" description="Anyone with the link can view it.">    …  </PopoverContent></Popover>

أمثلة

تصفية

خيارات قليلة وزر «تطبيق» (PopoverClose) يغلقها ويعيد التركيز إلى الزر. بلا زر إغلاق هنا: «إلغاء» وEsc يكفيان.

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

الجهات

‏side: أسفل (الافتراضي) وأعلى والبداية والنهاية. البداية والنهاية تتبعان اتجاه القراءة، فالبداية على اليمين بالعربية، والسهم يشير دائمًا إلى الزر. إن لم تتسع الجهة انقلبت إلى المقابلة.

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

مرجع الخصائص

Popover

الخاصيةالنوعالافتراضيالوصف
open / defaultOpenbooleanلا يوجدللتحكم في الفتح من الكود.
onOpenChange(open, details) => voidلا يوجدعند الفتح والإغلاق.

PopoverTrigger

الخاصيةالنوعالافتراضيالوصف
renderReactElementلا يوجدالزر الظاهر: <Button … />.

PopoverContent

الخاصيةالنوعالافتراضيالوصف
titleReactNodeلا يوجدخاصية Title: الغرض منها، وهو اسم النافذة.
descriptionReactNodeلا يوجدخاصية Description: سطر واحد تحت العنوان.
childrenReactNodeلا يوجدالمحتوى: حقل وزر، أو خيارات قليلة.
side"bottom" | "top" | "start" | "end""bottom"خاصية Side. تنقلب إن لم تتسع.
align"start" | "center" | "end""center"المحاذاة على طول تلك الجهة.
arrowbooleantrueالسهم نحو الزر.
closeButtonbooleantrueزر الإغلاق في نهاية الترويسة.
closeLabelstring"Close" / «إغلاق»اسم زر الإغلاق.
sideOffsetnumber12المسافة عن الزر.
initialFocus / finalFocusRefObject<HTMLElement>لا يوجدأين يبدأ التركيز وأين يعود.

PopoverClose

الخاصيةالنوعالافتراضيالوصف
renderReactElementلا يوجدزر في المحتوى يغلقها: «تطبيق»، «تم».

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

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

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

المفتاحما يفعله
EnterSpaceعلى الزر: يفتحها وينقل التركيز إلى أول حقل فيها، أو أول عنصر.
TabShift+Tabبين عناصرها. لا تحبس التركيز: الخروج منها يغلقها.
Escيغلقها ويعيد التركيز إلى الزر.

ARIA

  • نافذة غير مشروطة (role="dialog") اسمها عنوانها ووصفها سطرها الثاني.
  • للزر aria-expanded وaria-controls.
  • النقر خارجها يغلقها، والكتابة داخلها لا تغلقها أبدًا.
  • لا نافذة منبثقة داخل أخرى: استخدم نافذة حوارية للمهام الأكبر.

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

ينعكس

  • البداية والنهاية: البداية على اليمين بالعربية.
  • زر الإغلاق في نهاية الترويسة: على اليسار.
  • السهم يتبع الجهة ويشير إلى الزر في الاتجاهين.

لا ينعكس

  • الروابط والرموز والمعرّفات تبقى من اليسار إلى اليمين.
  • أسفل وأعلى لا يتغيران.
الأرقام
الأرقام داخلها تتبع إعداد الأرقام.
الخط العربي
العنوان label-16 Semibold والوصف label-14.
النص ثنائي الاتجاه
تنقل اتجاه الزر ولغته إلى المساحة المنبثقة، فمعاينة عربية في صفحة إنجليزية تبقى عربية. الحقل ذو dir="ltr" يبقي الرابط كاملًا من اليسار إلى اليمين.

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

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

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