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

التلميح

احصل على Ritla UI

يشرح أيقونة أو مصطلحًا ببضع كلمات عند المرور بالمؤشر أو التركيز بلوحة المفاتيح.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add tooltip

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

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

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

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

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

الاستخدام

tooltip.tsx
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} بلا سهم.

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

شريط أدوات

أزرار الأيقونات تسمّي إجراءها في تلميح أيضًا؛ TooltipProvider يجعل التلميح التالي يظهر فورًا.

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

مرجع الخصائص

Tooltip

الخاصيةالنوعالافتراضيالوصف
contentReactNodeلا يوجدخاصية Text: جملة قصيرة واحدة، بلا روابط أو أزرار.
childrenReactElementلا يوجدالعنصر القابل للتركيز الذي يشرحه.
side"top" | "bottom" | "inline-start" | "inline-end""top"خاصية Tooltip (الموضع).
align"start" | "center" | "end""center"‏Top left / Top right.
arrowbooleantrue‏Top no arrow.
delay / open / defaultOpen / onOpenChange…لا يوجدالتأخير والتحكم بالفتح.

IconTooltip / DefinitionTooltip

الخاصيةالنوعالافتراضيالوصف
labelstringلا يوجداسم زر المعلومات؛ الافتراضي «مزيد من المعلومات».
childrenReactNodeلا يوجدللتعريف: المصطلح (IBAN، APR).
…Tooltip props…لا يوجدكما في Tooltip.

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

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

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

المفتاحما يفعله
Tabالتركيز على المشغّل يُظهر التلميح.
Escapeيخفي التلميح.

ARIA

  • المشغّل يحمل aria-describedby يشير إلى نسخة مخفية من النص موجودة دائمًا، فيُقرأ الوصف حتى والتلميح مغلق.
  • لا تضع فيه ما يحتاجه الشخص لإكمال المهمة، ولا تعتمد عليه في شاشات اللمس فقط.

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

ينعكس

  • inline-start وinline-end تنعكسان: «يسار» Figma يصبح يمينًا في العربية.
  • الفقاعة المنفصلة تحمل اتجاه الصفحة ولغتها.

لا ينعكس

  • أيقونة المعلومات لا تنعكس.
الأرقام
الأرقام في النص تتبع numerals عبر formatNumber.
الخط العربي
‏body-12؛ السطر العربي أطول فتطول الفقاعة.
النص ثنائي الاتجاه
المصطلح اللاتيني مثل IBAN داخل جملة عربية يبقى سليمًا لأنه زر معزول.

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

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

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