CSS: tooltip ​

.instui-tooltip — یک حباب راهنمای ابزار (tooltip) که با hover و focus در CSS کار می‌کند و قابل قرارگیری در هر سمت است.

تغییر وضعیت کاملاً با CSS است (:hover/:focus-within)، بنابراین حباب فقط از طریق یک تریگر قابل فوکوس به کاربران کیبورد قابل دسترسی است؛ بر خلاف popover، قابل بستن یا راه‌اندازی‌شده با کلیک نیست.

Source: tooltip.css

TIP

افزایش JS — CSS این مؤلفه به‌تنهایی رندر و کار می‌کند؛ آن را با @pantoken/interactions جفت کنید تا رفتار تعاملی اضافه شود. جدول مدیفایرها در پایین را ببینید.

دسترس‌پذیری ​

با استفاده از aria-describedby تریگر را به حباب اشاره دهید و به حباب role="tooltip" اختصاص دهید.

نحوه استفاده ​

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/tooltip.css";

نمونه‌ها ​

html
<span class="instui-tooltip">
  <button class="instui-button" type="button" aria-describedby="placement-tip">محل قرارگیری</button>
  <span class="tip -placement-bottom" id="placement-tip" role="tooltip">این راهنمای ابزار در پایین ظاهر می‌شود.</span>
</span>

ساختار ​

text
.instui-tooltip
  [class*="-icon-"] (0..1)
  .tip
flowchart TD n0[".instui-tooltip"]:::cssdoc-root n1("[class*=&quot;-icon-&quot;]"):::cssdoc-part n2(".tip"):::cssdoc-part n0 -.->|0..1| n1 n0 --> n2 classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

تعدیل‌کننده‌ها ​

تعدیل‌کنندهتوضیحات
.-icon-*یک آیکون تریگر را در کنار حباب tooltip نمایش دهید.

قسمت‌ها ​

قسمتتوضیحات
.tipحباب؛ -placement-* سمت آن را تعیین می‌کند.

توکن‌های مصرف‌شده ​

Tokenنوعمقدار
--instui-border-radius-sm<length>0.25rem
--instui-color-background-inverse<color>LightDarklight-dark(#334450, #F2F4F5)
--instui-color-text-inverse<color>LightDarklight-dark(#ffffff, #1C222B)
--instui-component-tooltip-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-tooltip-font-size<length>0.875rem
--instui-component-tooltip-font-weight<integer>400
--instui-component-tooltip-padding<length>0.75rem
--instui-spacing-space-xs<length>0.25rem

مرتبط ​

  • popover — سطح متصل‌شدهٔ بزرگ‌تر که با کلیک فعال می‌شود.
  • context-view — یک سطح مرتبط متصل‌شده با پیکان.