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