项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。

EtScreenTip · 富提示 ​

替代 title 的提示:名称 + 一行说明 + 快捷键后缀,hover/focus 双触发、同屏单例。

紧凑 24
默认 32
宽松 40

API ​

import { EtScreenTip } from '@wil-works/evoke-tools-ui'公共工具反馈原子件

Props

名称类型默认说明
titleString必填提示名称(一行,必填)
descString''说明(一行,可选)
comboString''快捷键规范串(如 'mod+shift+z';非空时标题行渲染 EtKeyHint)
placementString'bottom'挂载方向:校验集与 EbTooltip 的 placement 校验一致(不另立一套)。 校验集就地内联 —— defineProps 的声明会被提升到 setup() 之外,validator 里 引用 <script setup> 的本地变量会直接编译失败
disabledBooleanfalse关闭提示

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 槽才是浮层内容;反了会把提示正文渲染进触发器。