
driver.js
新功能上线后,用户找不到入口;改动藏得太深,客服天天被问。这类问题最省事的解法是「第一次进页面时,高亮某个按钮并弹一句说明」。driver.js 就是干这个的轻量库,本站以前推荐过,这篇按官网现在的说法重写。

driver.js 能干什么:新手引导、单点高亮、上手清单
官网首页的原话是「Lightweight JavaScript library for product tours, highlights, and contextual help」。具体三种用法:
- Product tour(新手引导):一步一步走完整个流程,每步聚焦一个元素
- Feature hints(单点提示):只高亮一个按钮,配一句说明
- Onboarding checklist(上手清单):配合清单把「第一次要做的三件事」标出来
- 无依赖、纯原生 JS:官网列的特性里写着「Light-weight」「No dependencies」
- 跨浏览器与移动端:「Supports all Major Browsers」「Works on Mobile Devices」
- 可高度定制:「Highly Customizable」——遮罩、箭头、按钮文案、样式都能改
- MIT 许可:官网直接标了「MIT Licensed」,商用没问题
怎么加引导:装库、写步骤数组、首次访问才触发
- 引入库(
npm i driver.js或直接上 CDN 的 JS + CSS) - 定义步骤数组:每一步给一个
element选择器和一段popover文案 - 首次访问才触发(用
localStorage打标记),并提供「跳过」——强制引导是产品体验的头号杀手
核心写法就这么点:
const driver = new Driver({
steps: [
{ element: '#new-btn', popover: { title: '新建项目', description: '从这里开始' } },
{ element: '.filters', popover: { title: '筛选', description: '按状态快速找项目' } }
]
});
driver.drive();
MIT 免费,但 DOM 一改引导就指向空白
- 完全免费:MIT 许可,个人和商业项目都能用,没有付费档、没有账号
- 限制提醒:它是库不是产品:没有后台、没有埋点、没有「哪一步流失最多」的数据,要统计得自己接
- 高亮依赖 DOM 稳定:你的页面一改结构、选择器失效,引导就指向空白或者报错——上线前一定要回归一遍所有步骤
- SPA 里元素异步出现时容易指空:要等元素渲染完再
drive(),否则遮罩会框住一片空气 - 移动端小屏体验一般:弹窗容易挡住目标元素,步骤多于三四步时会显得吵
- 无障碍要自己补:遮罩会打断屏幕阅读器流程,键盘用户需要额外的焦点管理
- 别把「核心功能」藏进引导里:引导只是辅助,真正的解法是把入口做得更明显
- 性能开销很小但非零:一次性高亮几十个元素的做法会卡,按页分组更稳
别用引导掩盖设计问题:更该先做的几件事
- 想做整站级的引导流程设计:先用 tldraw 画清步骤
- 想给页面加动效反馈:Aceternity UI 或 Whirl
- 想做界面原型验证入口位置:tldraw 画草图更快
- 想查这些前端特性的兼容性:caniuse
- 想跑代码快速试一下:Jsitor
小提示:引导步骤别超过 5 步,且必须能跳过。行业里反复验证过的经验:用户接受引导的耐心大约在第 3 步耗尽,超过 5 步的引导完成率通常掉到个位数。与其教 8 步,不如把最关键的 1 个入口做得足够明显——好的产品不需要引导,糟糕的引导只会延迟用户逃离。
地址:https://driverjs.com/