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

تلميح

سطر أو سطران من النص عند التمرير أو التركيز: اسم عنصر تحكم بأيقونة فقط، أو تسمية مقطوعة.

client - الحجم لم يُقَس بعد

تلميح

client - الحجم لم يُقَس بعد

سطر أو سطران من النص عند التمرير أو التركيز: اسم عنصر تحكم بأيقونة فقط، أو تسمية مقطوعة.

تثبيت

جرّبه

placement
delay
closeDelay

الشيفرة

tooltip.tsx
import { linkSimple } from 'topclassui/icons/link-simple'
import { Button } from 'topclassui/button'
import { Svg } from 'topclassui/svg'
import { TooltipPopup, TooltipRoot, TooltipTrigger } from 'topclassui/tooltip'

<TooltipRoot>
  <TooltipTrigger
    render={
      <Button variant="ghost" aria-label="Copy link">
        <Svg icon={linkSimple} />
      </Button>
    }
  />
  <TooltipPopup>Copy link</TooltipPopup>
</TooltipRoot>

شاشات اللمس لا تعرض التلميح أبدًا، فيجب أن يكرّر اسم المشغّل النص نفسه: أعطِ الزر ذا الأيقونة فقط aria-label.

كل الحالات، بدون تمرير الفأرة

4 حالات

أو استورده من الحزمة

topclassui/tooltip
import { TooltipRoot, TooltipPopup, TooltipTrigger } from 'topclassui/tooltip'

ثبّت مرة واحدة:npm i topclassui@beta zod

أمثلة

  • ثلاثة أجزاء بأسماء مسطّحة، TooltipRoot وTooltipTrigger وTooltipPopup، ولا يوجد Tooltip وحده.
  • كل ما فيه رابط أو عنصر تحكم هو نافذة منبثقة: أبناء النافذة مكتوبون كنص، فيُرفض العنصر عند الترجمة.
  • delay وcloseDelay على المشغّل، محصوران بين 0 و10000 مللي ثانية؛ إن لم يُمرَّرا يُطبَّق 600 و0، أو التأخير المشترك من مزوّد التطبيق.
  • placement على النافذة، وtop افتراضيًا.
  • ضع نص المشغّل أو أيقونته داخل الزر الممرَّر إلى render، لا داخل TooltipTrigger، فتبقى التسمية تنتهي بعلامة حذف وتفسح الأيقونة مكانها لمؤشر التحميل.
basic
delays
long-label
with-count
placements
disabled
بالعربية، من اليمين إلى اليسار

الخصائص

TooltipRoot

لا خصائص خاصة به: يأخذ سمات العنصر الذي يعرضه.

TooltipPopup

خصائص TooltipPopup
الخاصيةالنوعالافتراضيالحدودالوصف
childrenTooltipText | readonly TooltipText[]--Text only, never an element: a link or a control belongs in a Popover (R-10.5-2).
placementtop | top-start | top-end | bottom | bottom-start | bottom-end | start | start-top | start-bottom | end | end-top | end-bottom"top"-TooltipPopup: the side and alignment it opens at; start and end mirror in Arabic.

TooltipTrigger

خصائص TooltipTrigger
الخاصيةالنوعالافتراضيالحدودالوصف
closeDelaynumber, min 0, max 100000min 0, max 10000TooltipTrigger: milliseconds it stays open after the pointer leaves, clamped.
delaynumber, min 0, max 10000600min 0, max 10000TooltipTrigger: milliseconds of hover before it opens, clamped to the limits.

لوحة المفاتيح وإمكانية الوصول

لوحة مفاتيح Tooltip
المفاتيحما يفعله
Tabالتركيز على المشغّل يفتح التلميح.
Escapeيغلق التلميح. داخل مربع حوار، يغلق Escape التالي مربع الحوار.
  • لا يربط Base UI النافذة بأي عنصر، فاسم المشغّل هو الذي يحمل النص، لا التلميح.
  • أبناء النافذة مكتوبون كنص: العنصر أو الرابط أو عنصر التحكم يُرفض عند الترجمة.

من اليمين إلى اليسار

start يفتح على اليمين وend على اليسار. الموضع الافتراضي top يبقى في الأعلى.

الخادم والمتصفح

مكوّن متصفح: يُعرض على الخادم ثم يُرطَّب في المتصفح.

الملفات: index.tsx, client.tsx.

على الشارة: client - الحجم لم يُقَس بعد.