在 Vue 3 中需将 audio.currentTime 封装为 ref 响应式变量,通过 timeupdate 事件同步更新;歌词数组按时间升序排列,watch currentTime 动态匹配当前行索引并高亮;再通过 scrollIntoView 实现当前行居中滚动。

在 Vue 3 中用 watch 监听音频播放时间戳实现歌词高亮滚动,核心是监听 audio.currentTime 的变化,并与歌词时间轴比对,动态更新当前行索引。但要注意:直接 watch 原生 audio.currentTime 不可行(它不是响应式数据),必须将其封装为响应式变量(如 ref),再通过 timeupdate 事件同步更新。
1. 创建响应式播放时间并绑定 audio 事件
在 setup 中定义 currentTime 为 ref(0),并在 onMounted 中为 元素添加 timeupdate 事件监听器,实时更新该 ref:
- 确保 audio 元素已挂载(用
template ref获取 DOM 实例) - 在组件卸载前移除事件监听,避免内存泄漏
- 推荐使用
requestAnimationFrame节流(可选),防止高频触发影响性能
2. 歌词数据格式需带时间戳(毫秒或秒)
歌词应为数组,每项含 time(起始时间,单位建议统一为秒)和 text:
[{ time: 0, text: "从前的日色变得慢" },<br>
{ time: 3.2, text: "车,马,邮件都慢" },<br>
{ time: 6.8, text: "一生只够爱一个人" }]注意:时间需升序排列;若存在多行同时间,可取第一行或合并处理。
3. 用 watch 精确匹配当前歌词行
监听 currentTime,遍历歌词数组,找到满足 lyric.time ≤ currentTime 的索引(即当前播放行):
- 使用
watch(currentTime, (newTime) => {...}),避免过度计算(如防抖非必需,因timeupdate本身较频繁但可控) - 用
findIndex或双指针优化查找(尤其歌词长时),避免每次全量遍历 - 将匹配到的索引存为
currentLineIndex(ref),模板中用v-for+:class="{ active: i === currentLineIndex }"控制高亮
4. 滚动同步:让当前行居中显示
歌词容器需启用滚动,当 currentLineIndex 变化时,调用 scrollIntoView 或手动设置 scrollTop:
- 给每行歌词加
ref(如lineRefs数组),通过lineRefs[currentLineIndex]?.scrollIntoView({ block: 'center' }) - 若需平滑滚动,加
{ behavior: 'smooth' };首次加载可延迟执行(nextTick确保 DOM 渲染完成) - 注意:滚动逻辑放在
watch回调内,或用watchEffect自动追踪currentLineIndex
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










