web-haptics
为移动端网页应用提供标准化触觉反馈的轻量级库。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:web-haptics。 它的用途是:为移动端网页应用提供标准化触觉反馈的轻量级库。 完整的 Skill 内容见:https://321skill.com/skills/web-haptics/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在开发一个移动端的任务管理应用,想在用户完成任务勾选复选框时,提供一个轻微的触觉反馈,该怎么用 web-haptics 实现?” 它会指导你安装 `web-haptics` 库,并在你的 React/Vue 组件中导入 `useWebHaptics` hook,然后在复选框的 `onChange` 事件里调用 `haptic.trigger('light')` 即可。
介绍
web-haptics 解决了移动端网页应用缺乏触觉反馈,导致交互体验生硬、缺乏物理感的问题。它封装了 Web Vibration API,让开发者只需一行代码即可为按钮、开关、表单等交互元素添加符合直觉的振动反馈,提升用户体验。
使用方式极其简单:通过 npm 安装后,即可在 React、Vue、Svelte 或原生 JavaScript 项目中导入。库提供了 trigger() 方法,并预置了“success”、“light”、“selection”等多种语义化的触发类型,开发者无需关心底层 API 细节或平台兼容性。
它非常适合面向移动端用户的 Web 应用开发者,尤其是那些注重交互细节、希望提升应用专业度和用户参与感的产品团队。无论是电商应用的购买确认、表单提交的成功/失败提示,还是工具类应用的滑动选择器,都能从中受益。
与同类工具相比,web-haptics 的核心优势在于其“设计导向”和“零负担”理念。它不仅是一个技术实现,更严格遵循苹果 HIG 等设计规范,提供了详细的触觉使用规则。同时,它在不支持的环境下静默失效,无需错误处理,做到了真正的开箱即用和无侵入集成。
核心特点
严格遵循苹果 HIG 等设计规范,将触觉反馈从技术实现提升到设计原则层面;提供语义化的预设(如 success, selection)而非简单的振动模式,并内置静默失效机制,实现真正的零配置、无错误处理集成。
注意事项
仅适用于支持 Web Vibration API 的移动端浏览器,在桌面端会静默失效,不适合需要强触觉反馈的桌面网页或原生应用场景。
常见问题
web-haptics 在桌面浏览器上能用吗?
不能,它会静默失效,这是设计使然,旨在专注于移动端体验。
需要为不同的框架安装不同的包吗?
不需要,同一个 npm 包内提供了针对 React、Vue、Svelte 和原生 JS 的适配器,按需导入即可。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/web-haptics/raw/index.md 读取 web-haptics 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/web-haptics/raw/index.md(查看排版版本)