نظرة عامة
يقتطعOverflowingTextWithTooltip المحتوى ضمن العرض المتاح. يتحقق من التجاوز عند دخول المؤشر وعند التركيز، ثم يعرض تلميحًا عند الحاجة فقط. يدير ظهور التلميح داخليًا ولا يوفّر أي خصائص لحالة الفتح المضبوطة أو غير المضبوطة. استخدم OverflowingTextTooltipModeProvider لتغيير وقت تحقّق شجرة فرعية من الاقتطاع أو لإيقاف تلميح الأداة.
استخدام
isFocusable النص نقطة توقف في التنقل بالضغط على Tab ويفتح التلميح عند التركيز أو النقر. أبقِ المعلومات الأساسية متاحة للمستخدمين الذين لا يمكنهم التمرير فوق العنصر.
اختيار الطباعة
تتطابقsize وweight وcolor مع النص. إنها اختيارية وتُورَّث بشكل مستقل عند حذفها. تُطبَّق الطباعة الصريحة على النص المعروض؛ بينما تحتفظ تلميحة الأداة بمظهرها المشترك.
محتوى متعدد الأسطر
lineClamp مع Text وتحدّ من الأسطر المعروضة؛ استخدم عددًا صحيحًا موجبًا. يحافظ isTooltipMultiline على المسافات البيضاء وفواصل الأسطر داخل التلميح. من دون حد لعدد الصفوف، يُقتطع النص في سطر واحد.
محتوى وتوقيت مخصصان
tooltipContent كسلسلة نصية عادية. مع النص من نوع سلسلة، يمكن لتلك الخاصية تجاوز تسمية التلميح؛ وإلا يُستخدم النص نفسه. لا تفتح التسمية الفارغة أو المفقودة تلميحًا. تظل عناوين URL النصية نصًا عاديًا. وفّر الروابط صراحةً في text أو عبر render. يبقى محتوى الرابط والتنقل تحت تحكم المستدعي.
يسمح alwaysShowTooltip بعرض التلميح حتى من دون اقتطاع. يتحكم tooltipDelay في تأخير التمرير ويكون افتراضيًا 500 مللي ثانية. تكون القيمة الافتراضية لـ tooltipPlace هي bottom.
تستهدف السمات والأنماط وأسماء الفئات ومعالجات الأحداث والمراجع الأصلية عنصر Text المعروض، وهو div افتراضياً. يمكن لـ render استبدال ذلك العنصر مع الاحتفاظ بسلوك الاقتطاع وتلميح الأدوات. يتم تصدير OverflowingTextWithTooltipProps من twenty-ui/primitives/typography. تُورَّث الطباعة من التخطيط المحيط ما لم يتم توفير خاصية طباعة صريحة. عيّن truncate={false} للالتفاف؛ اختر إما truncate أو lineClamp. تكشف العناصر المعروضة القابلة للتركيز وtabIndex الذي يوفره المستدعي أيضاً تلميح الأدوات عند التركيز. استخدم Text وTooltip مباشرةً عندما تحتاج إلى تركيب مخصص. ينتمي محتوى النافذة المنبثقة التفاعلي إلى Popover.
روابط صريحة
tooltipContent عادي. لا يضيف المكوّن أي روابط مرساة من تلقاء نفسه. اجعل محتوى تلميح الأدوات معلوماتياً.
الترحيل
استبدلdisplayedMaxRows بـ lineClamp. كانت خيارات size="small" وsize="large" السابقة تتحكم في الارتفاع، وليس حجم الخط. يضبط large ارتفاعًا قدره 16px. تختار size الجديدة أحجام خطوط النسق ولا تقبل أي أسماء مستعارة قديمة؛ استخدم style أو className الأصليين لقيود الارتفاع. يقبل color الآن ألوانًا دلالية؛ انقل ألوان CSS العشوائية إلى style={{ color: customColor }}. انقل التعرّف المقصود على عناوين URL إلى محتوى يتحكم فيه المستدعي. لم يعد هناك تحويل تلقائي إلى روابط في هذا المكوّن.
الإزاحة
boolean
Allows the tooltip even when the text is not truncated.
"light" | "primary" | "secondary" | "tertiary"
Semantic text color. Omitted values inherit; native style supports runtime colors.
boolean
Adds an optional tab stop. Native tabIndex and focusable render elements also open the tooltip on focus.
boolean
Preserves whitespace and line breaks in the tooltip.
number
Positive integer limiting visible lines, matching Text. Cannot be combined with
truncate.ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Replaces the default div. Native props, styles, handlers and ref target the displayed text, not the popup.
"lg" | "md" | "sm" | "xl" | "xs" | "xxl" | "xxs"
Font size from the theme scale. Omitted values inherit; this does not set height.
string | number | bigint | boolean | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | Promise<...> | null | undefined
مطلوب
Caller-owned text or React content. Non-string content requires
tooltipContent. URLs stay plain text.string
Plain text displayed in the tooltip. Defaults to nonempty string
text.number
Hover delay in milliseconds.
"bottom" | "inline-end" | "inline-start" | "left" | "right" | "top"
Preferred side of the tooltip.
boolean
Single-line ellipsis by default. Set false to wrap. Cannot be combined with
lineClamp."medium" | "regular" | "semibold"
Theme font weight. Omitted values inherit.