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

بطاقة المعاينة

احصل على Ritla UI

معاينة للقراءة فقط لما يشير إليه رابط، تظهر حين يستقر المؤشر عليه أو يصله التركيز.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add hover-card

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

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

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

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

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

الاستخدام

hover-card.tsx
import { HoverCard, HoverCardContent, HoverCardProfile, HoverCardTrigger } from "@/components/ui/hover-card";<HoverCard>  <HoverCardTrigger href="/people/noor">Noor Al-Hassan</HoverCardTrigger>  <HoverCardContent>    <HoverCardProfile name="Noor Al-Hassan" handle="@noor.designs" bio="Product designer in Amman." />  </HoverCardContent></HoverCard>

أمثلة

تاجر، في الأعلى

‏side="top" على صف معاملة. النطاق يبقى من اليسار إلى اليمين، والأرقام تتبع إعداد الأرقام.

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

مرجع الخصائص

HoverCardTrigger

الخاصيةالنوعالافتراضيالوصف
hrefstringلا يوجدالرابط: يبقى رابطًا يُتبع بالنقر أو اللمس.
delaynumber500كم ينتظر المؤشر على الرابط قبل الفتح (ملّي ثانية).
closeDelaynumber300كم تبقى بعد مغادرة المؤشر الرابط والبطاقة.
renderReactElementلا يوجدرابطك الخاص، مثل <Link /> من Next.

HoverCardContent

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدمحتوى للقراءة فقط: بلا أزرار ولا روابط ولا حقول.
side"bottom" | "top" | "start" | "end""bottom"خاصية Side. تنقلب إن لم تتسع.
align"start" | "center" | "end""center"المحاذاة على طول تلك الجهة.
arrowbooleantrueالسهم نحو الرابط.

HoverCardProfile

الخاصيةالنوعالافتراضيالوصف
namestringلا يوجدخاصية Name، وحروف الصورة الرمزية.
handlestringلا يوجدخاصية Handle: معرّف أو نطاق، من اليسار إلى اليمين.
srcstringلا يوجدصورة الشخص؛ وبدونها الحروف.
bioReactNodeلا يوجدخاصية Bio: سطران تقريبًا.
facts{ icon?; label }[]لا يوجدخاصية Meta: حقائق قصيرة بأيقونة.

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

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

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

المفتاحما يفعله
Tabالتركيز على الرابط يفتحها بعد المهلة، ومغادرته تغلقها.
Escيغلقها والتركيز باقٍ على الرابط.
Enterيتبع الرابط.

ARIA

  • البطاقة إضافة بصرية: كل ما فيها موجود في الصفحة التي يفتحها الرابط، فقارئ الشاشة لا يفقد شيئًا.
  • لا عناصر تفاعلية فيها، لأنها تغلق حين يغادر المؤشر أو التركيز الرابط.
  • على الشاشات اللمسية يتبع النقر الرابط مباشرة.

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

ينعكس

  • الصورة الرمزية في البداية: على اليمين، والنص بعدها.
  • الحقائق تبدأ من اليمين، والأيقونة قبل كل نص.

لا ينعكس

  • المعرّفات والنطاقات (@noor.designs) تبقى من اليسار إلى اليمين.
  • أيقونات الموقع والتقويم لا تنعكس.
الأرقام
السنوات والأعداد في الحقائق تتبع إعداد الأرقام؛ نسّقها بـ formatNumber.
الخط العربي
الاسم label-16 Semibold، والمعرّف label-14، والنبذة body-14، والحقائق label-12.
النص ثنائي الاتجاه
الاسم في <bdi> والمعرّف في <bdi dir="ltr">، والنبذة dir="auto" لأنها قد تأتي بأي لغة.

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

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

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