用 canvas 抽帧 + video 的 seeked 事件实现毫秒级精准预览条最可控,需设置 crossOrigin="anonymous"、按需抽帧、动态计算缩略图尺寸、监听 seeked 而非 timeupdate 触发截图,并适配 touch/mouse 事件及设备像素比。

用 canvas 抽帧 + video 的 seeked 事件做预览条最可控
纯 CSS 或第三方库(比如 Video.js 插件)往往卡在精度、跨域或自定义样式上,真正能按毫秒级定位、自由缩放、响应鼠标拖拽的,还是得自己用 canvas + 原生 video 控制流。核心是利用 video 的 currentTime 跳转 + drawImage 截图,再拼成横向缩略图序列。
关键点:
-
video必须设置crossOrigin="anonymous",否则canvas读取帧会触发SecurityError: Failed to execute 'toDataURL' on 'HTMLCanvasElement' - 抽帧不宜过密(比如每 100ms 一帧),否则生成大量
img标签或 canvas 绘制压力大,页面卡顿 - 预览条容器宽度建议用
scrollWidth+overflow-x: auto实现平滑拖拽,别用transform: translateX模拟滚动——会影响鼠标坐标计算
video.addEventListener('seeked', ...) 是同步触发预览高亮的唯一可靠时机
用户拖动进度条时,timeupdate 事件可能滞后或被节流,而 seeked 表示跳转已实际完成、画面已渲染,此时调用 canvas.drawImage(video, ...) 才能拿到真实帧。直接在 input 或 change 事件里抽帧,大概率截到黑帧或上一帧。
实操建议:
- 监听
seeked后立即计算当前时间点对应的缩略图索引:Math.round(currentTime / frameInterval) - 用
requestAnimationFrame包裹高亮逻辑,避免重复绘制 - 高亮元素不要用
box-shadow或outline,改用border: 2px solid #007bff,更稳定且不触发重排
缩略图尺寸和数量要按视频分辨率和容器宽度动态算
硬编码缩略图宽高(比如统一设成 64×36)会导致拉伸失真或空白间隙。正确做法是:先用 video.videoWidth / video.videoHeight 获取原始分辨率,再按容器总宽度反推单张缩略图宽度。
例如容器最大宽 800px,视频时长 120s,抽帧间隔 0.5s → 共 240 帧 → 单张缩略图宽 = Math.floor(800 / 240) ≈ 3px?显然太小。这时应限制最小缩略图宽度为 16px,并相应减少抽帧数:maxThumbs = Math.floor(800 / 16) → 实际抽帧间隔 = duration / maxThumbs。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
容易踩的坑:
- 没检查
video.readyState === 4就开始抽帧,videoWidth返回 0 - 用
offsetWidth取容器宽度,但容器尚未渲染完成(如在DOMContentLoaded里执行),应改用getBoundingClientRect() - 缩略图用
img标签加载 base64,大量并发请求导致内存暴涨,推荐用canvas直接绘制并缓存canvas.toDataURL()结果
移动端拖拽预览条必须处理 touchstart/touchmove 并禁用默认行为
桌面端靠 mousedown/mousemove 能跑通,但 iOS Safari 对 mousemove 支持弱,且默认有延迟。不加 touch-action: none 和 preventDefault(),手指一划就触发页面滚动,预览条完全无法拖动。
代码片段示意:
previewBar.addEventListener('touchstart', e => {
e.preventDefault();
isDragging = true;
startX = e.touches[0].clientX;
});
previewBar.addEventListener('touchmove', e => {
if (!isDragging) return;
e.preventDefault();
const deltaX = e.touches[0].clientX - startX;
// 计算对应时间并设置 video.currentTime
});
注意:e.preventDefault() 必须在 touchstart 和 touchmove 中都调用,只在后者里加无效;另外 iOS 上 touchend 可能不触发,建议加 touchcancel 清理状态。
复杂点在于不同设备像素比(window.devicePixelRatio)下 canvas 绘制模糊——缩略图 canvas 需要按 DPR 缩放画布尺寸,再用 CSS 缩回,否则高清屏上全是马赛克。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










