Skip to content

提示框

属性 ​

属性类型默认值说明
contentstring—提示文字。需要展示富文本时,改用 content 插槽。
placement'above' | 'below' | 'start' | 'end''above'提示相对触发元素的方向。所选方向空间不足时会自动翻转。
alignment'start' | 'center' | 'end''center'气泡沿位置方向的对齐方式:靠起始端、居中或靠末端。
delaynumber200悬停或聚焦后,提示显示前的等待时间(毫秒)。
hideDelaynumber0鼠标或焦点离开后,提示隐藏前的等待时间(毫秒)。为 0 时使用 100 毫秒,给鼠标移入气泡留出时间。
focusTrigger'auto' | 'always' | 'never''auto'聚焦时是否显示提示:auto 仅在触发元素本身可聚焦时监听,always 始终监听,never 从不监听。
touchTrigger'auto' | 'tap' | 'none''auto'触摸设备上点击触发元素时的行为:auto 时点击切换提示,但按钮、链接和表单控件自身的点击不触发;tap 总是切换;none 不打开。
isEnabledbooleantrue是否启用提示。为 false 时禁用悬停与聚焦触发。
hasHoverIndication'auto' | boolean'auto'是否在纯文字触发元素上显示虚线下划线。auto 时仅对纯文字触发元素生效。
isOpenboolean—受控显示状态。设置后悬停与聚焦不再触发提示。
isDefaultOpenbooleanfalse是否在挂载时就显示提示。仅在未设置 isOpen 时生效。

事件 ​

  • openChange(isOpen: boolean):提示显示或隐藏时触发。受控模式下,按 Escape 会发出 false,由父组件决定是否关闭。

插槽 ​

  • default:触发元素。
  • content:富文本提示内容。会替代 content 属性的文字。

主题 ​

css
.my-tooltip {
  --astryx-tooltip-background: #000;
  --astryx-tooltip-foreground: #fff;
}
  • --astryx-tooltip-background:气泡背景色。
  • --astryx-tooltip-foreground:气泡文字颜色。
  • --astryx-tooltip-indication-color:虚线下划线颜色。
  • --astryx-tooltip-z-index:气泡的层叠顺序。