Agent Skills
返回列表
字段悬停提示

字段悬停提示

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/rq20260535。

技能介绍

解决表单字段解释难题

在复杂的 B 端产品中,表单字段(如特定业务指标、审批规则)往往带有隐含逻辑。仅靠占位符或帮助文档难以直观传达,强行增加说明文字又会破坏表单排版。

核心实现与挂载步骤

该技能基于 tippy.js 构建,通过轻量级交互解决字段说明问题:

  • 动态挂载:在字段 label 旁自动渲染帮助图标,将长文本说明转移至悬浮层,保持界面整洁。
  • 内容渲染:支持纯文本及可信 HTML,开发者可通过 allowHTML: true 灵活控制排版。
  • 内存管理:在组件卸载阶段(onBeforeUnmount)必须调用 destroy(),确保无残留节点,防止内存泄漏。

适用边界与安全警告

此技能适用于局部字段释义,并非全站导览工具。

注意:若开启 allowHTML,严禁直接注入未经消毒的用户输入,以防 XSS 攻击。推荐使用 tippy.js 官方 CSS 以获得最佳显示效果。

使用场景

  • 在商机录入表单中,为“预计成交金额”等含义模糊字段旁添加问号图标,悬停时显示计算口径说明。
  • 在产品 Demo 的指标卡片中,为“环比增长率”表头提供悬停帮助,解释数据来源与统计周期。
  • 在数据列表表头为“字段状态”添加简短帮助,避免用户误解枚举值含义。
  • 在移动端表单中,将字段说明触发方式改为点击,让用户在触控场景下查看字段释义。

适合人员

  • 前端开发者:需要在表单组件中集成轻量悬停说明并避免内存泄漏。
  • SaaS 演示者:希望在 Demo 页面为指标和表单字段补充即时解释。
  • B 端产品经理:为复杂业务表单设计字段帮助,降低用户理解成本。
  • 交互设计师:验证字段说明在桌面悬停与移动端点击下的可访问性。