必须等待 loadedmetadata 事件触发后才能安全使用 audio.duration 设置进度条 max 值,直接使用初始 NaN 会导致拖动失效;设 currentTime 前需检查 readyState ≥ 2,并监听 seeked 事件同步 UI;移动端须绑定 touchstart/touchmove 并节流,动态插入的 audio 需单独绑定事件或用事件委托。

拖动进度条没反应,大概率是 duration 还没就绪
audio.duration 初始值是 NaN,直接拿它算 max 或设 currentTime 会静默失败——进度条滑块拖不动、拖了也不跳转,控制台还不报错。必须等 loadedmetadata 事件触发后才能安全使用 duration。
- 在
audio元素上监听loadedmetadata,而不是靠 DOM 加载完成就初始化进度条 -
的max属性必须在该事件后动态设为audio.duration,不能写死或提前赋值 - 如果音频文件极小(如 100KB 以下),
loadedmetadata可能比 JS 执行还快,但别赌——统一走事件驱动更稳
currentTime 设了却跳不准确,检查 readyState 和 seeking 状态
直接赋值 audio.currentTime = value 不保证立即生效,尤其在网络差、文件未缓冲完时。浏览器可能卡在 HAVE_CURRENT_DATA(只够播当前帧),还没到 HAVE_FUTURE_DATA(能向前寻址)。
- 设值前先判断
audio.readyState >= 2,否则跳转大概率失败或延迟 - 监听
seeking(开始跳转)和seeked(跳转完成)事件,UI 同步只在seeked后更新,避免“拖完还在原位置”的错觉 - 移动端 iOS Safari 对
currentTime设置精度容忍度低,建议四舍五入到小数点后一位(如Math.round(value * 10) / 10)
移动端滑动条响应迟钝或只触发一次,别只绑 change
桌面端用 input 事件监听 range 滑动很顺,但移动端 touch 行为不同:change 只在松手后触发一次,input 在部分 Android 浏览器里也不稳定。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 必须同时绑定
touchstart+touchmove,并在touchmove中调用event.preventDefault()防止页面滚动干扰 -
touchmove里实时设audio.currentTime,但要加节流(如requestAnimationFrame包裹),避免高频触发导致卡顿 - 别忘了 fallback:对不支持 touch 的设备(如带触控笔的 Windows 笔记本),仍保留
input和change监听
动态插入的 audio 元素拖动失效,事件监听没跟上 DOM 更新
如果你用 JS 动态创建 audio 标签(比如从列表渲染多个播放器),然后批量用 document.querySelectorAll('audio') 绑事件——那新增的元素根本不会响应拖动。
- 监听逻辑不能写在脚本顶层,必须封装成函数,在每个 audio 插入 DOM 后立即调用
- 或者改用事件委托:监听父容器的
input或touchmove,再用event.target.closest('input[type="range"]')判断是否来自播放器进度条 - 确保每个动态 audio 都有唯一 ID 或 data 属性,方便在事件处理中精准匹配对应实例
真正容易被忽略的是:iOS Safari 下,即使所有状态都对,currentTime 设值后若立刻读取,返回的仍是旧值——它需要一个微任务周期才更新。别在设完马上做 UI 同步,等 seeked 或下一轮 timeupdate 更可靠。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










