بطاقة المعاينة
معاينة للقراءة فقط لما يشير إليه رابط، تظهر حين يستقر المؤشر عليه أو يصله التركيز.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add hover-cardويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/hover-cardالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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" على صف معاملة. النطاق يبقى من اليسار إلى اليمين، والأرقام تتبع إعداد الأرقام.
مرجع الخصائص
HoverCardTrigger
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
href | string | لا يوجد | الرابط: يبقى رابطًا يُتبع بالنقر أو اللمس. |
delay | number | 500 | كم ينتظر المؤشر على الرابط قبل الفتح (ملّي ثانية). |
closeDelay | number | 300 | كم تبقى بعد مغادرة المؤشر الرابط والبطاقة. |
render | ReactElement | لا يوجد | رابطك الخاص، مثل <Link /> من Next. |
HoverCardContent
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | محتوى للقراءة فقط: بلا أزرار ولا روابط ولا حقول. |
side | "bottom" | "top" | "start" | "end" | "bottom" | خاصية Side. تنقلب إن لم تتسع. |
align | "start" | "center" | "end" | "center" | المحاذاة على طول تلك الجهة. |
arrow | boolean | true | السهم نحو الرابط. |
HoverCardProfile
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
name | string | لا يوجد | خاصية Name، وحروف الصورة الرمزية. |
handle | string | لا يوجد | خاصية Handle: معرّف أو نطاق، من اليسار إلى اليمين. |
src | string | لا يوجد | صورة الشخص؛ وبدونها الحروف. |
bio | ReactNode | لا يوجد | خاصية Bio: سطران تقريبًا. |
facts | { icon?; label }[] | لا يوجد | خاصية Meta: حقائق قصيرة بأيقونة. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | التركيز على الرابط يفتحها بعد المهلة، ومغادرته تغلقها. |
| Esc | يغلقها والتركيز باقٍ على الرابط. |
| Enter | يتبع الرابط. |
ARIA
- البطاقة إضافة بصرية: كل ما فيها موجود في الصفحة التي يفتحها الرابط، فقارئ الشاشة لا يفقد شيئًا.
- لا عناصر تفاعلية فيها، لأنها تغلق حين يغادر المؤشر أو التركيز الرابط.
- على الشاشات اللمسية يتبع النقر الرابط مباشرة.
ملاحظات العربية والاتجاه
ينعكس
- الصورة الرمزية في البداية: على اليمين، والنص بعدها.
- الحقائق تبدأ من اليمين، والأيقونة قبل كل نص.
لا ينعكس
- المعرّفات والنطاقات (
@noor.designs) تبقى من اليسار إلى اليمين. - أيقونات الموقع والتقويم لا تنعكس.
- الأرقام
- السنوات والأعداد في الحقائق تتبع إعداد الأرقام؛ نسّقها بـ
formatNumber. - الخط العربي
- الاسم
label-16Semibold، والمعرّفlabel-14، والنبذةbody-14، والحقائقlabel-12. - النص ثنائي الاتجاه
- الاسم في
<bdi>والمعرّف في<bdi dir="ltr">، والنبذةdir="auto"لأنها قد تأتي بأي لغة.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.