CSS: tooltip ​

.instui-tooltip — 一个 CSS 悬停与聚焦的提示气泡，可定位在任意一侧。

切换为纯 CSS（:hover/:focus-within），因此该气泡仅能通过可聚焦的触发器供键盘用户访问；与 popover 不同，它不可取消且不会由点击触发。

Source: tooltip.css

TIP

JS 增强 — 该组件的 CSS 可独立渲染与工作；将其与 @pantoken/interactions 配对可添加交互行为。参见下方的 modifier table。

无障碍 ​

使用 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-*在提示气泡旁渲染一个触发字形图标。

部件 ​

部件描述
.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 — 带指针的相关锚定表面。