字段悬停提示
将以下提示词粘贴到你的 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 端产品经理:为复杂业务表单设计字段帮助,降低用户理解成本。
- 交互设计师:验证字段说明在桌面悬停与移动端点击下的可访问性。