Skip to content

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" aria-describedby="tt-1">
  <span class="instui-icon -icon-info"></span>
  <span class="tip" id="tt-1" role="tooltip">Default placement is top</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 — 带指针的相关锚定表面。