EtScreenTip · 富提示
替代 title 的提示:名称 + 一行说明 + 快捷键后缀,hover/focus 双触发、同屏单例。
紧凑 24
默认 32
宽松 40
API
Props
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
| title | String | 必填 | 提示名称(一行,必填) |
| desc | String | '' | 说明(一行,可选) |
| combo | String | '' | 快捷键规范串(如 'mod+shift+z';非空时标题行渲染 EtKeyHint) |
| placement | String | 'bottom' | 挂载方向:校验集与 EbTooltip 的 placement 校验一致(不另立一套)。 校验集就地内联 —— defineProps 的声明会被提升到 setup() 之外,validator 里 引用 <script setup> 的本地变量会直接编译失败 |
| disabled | Boolean | false | 关闭提示 |
Slots
| 槽 | 吃什么 | 作用域 |
|---|---|---|
| default | 提示正文(默认渲染 name / desc / keys 三段) | |
暴露(ref 方法)
| 方法 | 说明 |
|---|---|
| show() | 发起显示(走单例 + 延迟契约;不是裸转发——裸转发会绕过二者) |
| hide() | 收起(走自动隐藏延时) |
| update() | 位置刷新:直通 EbTooltip |
键盘 · 可访问名 · 密度
| 键盘 | 不接管按键 |
|---|---|
| 可访问名 | 无 ARIA 属性(原生语义) |
| 密度 | --et-density-base-font--et-density-line-height |
行为
- 延迟契约:首显 400ms / 热显 120ms / 自动隐藏 200ms;一次提示出现后 1 秒内再触发走热显档。
- 单例:模块级登记表,任一发起显示即收起其它实例。
- hover 走冒泡
mouseover/mouseout+relatedTarget判进出;键盘走focusin/focusout。 - Esc 与外部按下收起由底座全局监听负责。
- 暴露
show()/hide()/update();show()走单例 + 延迟契约,不是裸转发。 title缺失时 dev warn。
令牌与门禁
--et-screentip-delay-first/-hot/-hide三个令牌与 JS 侧常量同源(改令牌要同步常量)。- G4:
title是必填 prop。 - 槽位语义:默认子内容是触发器,
content槽才是浮层内容;反了会把提示正文渲染进触发器。