التلميح
يشرح أيقونة أو مصطلحًا ببضع كلمات عند المرور بالمؤشر أو التركيز بلوحة المفاتيح.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add tooltipويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/tooltipالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { DefinitionTooltip, IconTooltip, Tooltip } from "@/components/ui/tooltip";<IconTooltip content="Fees apply to international transfers." /><DefinitionTooltip content="International bank account number">IBAN</DefinitionTooltip><Tooltip content="Copy IBAN"><IconButton icon={CopyIcon} label="Copy IBAN" /></Tooltip>أمثلة
الموضع والسهم
side أعلى أو أسفل أو بداية السطر أو نهايته (ينعكس في العربية)، وalign للبداية أو النهاية، وarrow={false} بلا سهم.
شريط أدوات
أزرار الأيقونات تسمّي إجراءها في تلميح أيضًا؛ TooltipProvider يجعل التلميح التالي يظهر فورًا.
مرجع الخصائص
Tooltip
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
content | ReactNode | لا يوجد | خاصية Text: جملة قصيرة واحدة، بلا روابط أو أزرار. |
children | ReactElement | لا يوجد | العنصر القابل للتركيز الذي يشرحه. |
side | "top" | "bottom" | "inline-start" | "inline-end" | "top" | خاصية Tooltip (الموضع). |
align | "start" | "center" | "end" | "center" | Top left / Top right. |
arrow | boolean | true | Top no arrow. |
delay / open / defaultOpen / onOpenChange | … | لا يوجد | التأخير والتحكم بالفتح. |
IconTooltip / DefinitionTooltip
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | string | لا يوجد | اسم زر المعلومات؛ الافتراضي «مزيد من المعلومات». |
children | ReactNode | لا يوجد | للتعريف: المصطلح (IBAN، APR). |
…Tooltip props | … | لا يوجد | كما في Tooltip. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | التركيز على المشغّل يُظهر التلميح. |
| Escape | يخفي التلميح. |
ARIA
- المشغّل يحمل
aria-describedbyيشير إلى نسخة مخفية من النص موجودة دائمًا، فيُقرأ الوصف حتى والتلميح مغلق. - لا تضع فيه ما يحتاجه الشخص لإكمال المهمة، ولا تعتمد عليه في شاشات اللمس فقط.
ملاحظات العربية والاتجاه
ينعكس
inline-startوinline-endتنعكسان: «يسار» Figma يصبح يمينًا في العربية.- الفقاعة المنفصلة تحمل اتجاه الصفحة ولغتها.
لا ينعكس
- أيقونة المعلومات لا تنعكس.
- الأرقام
- الأرقام في النص تتبع
numeralsعبرformatNumber. - الخط العربي
-
body-12؛ السطر العربي أطول فتطول الفقاعة. - النص ثنائي الاتجاه
- المصطلح اللاتيني مثل IBAN داخل جملة عربية يبقى سليمًا لأنه زر معزول.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.