HTML网页怎么动态加载字幕标签?脚本控制基础方法

标签必须在 内部声明,且不能靠 JavaScript 动态创建后追加——浏览器只在解析 初始 HTML 时扫描并注册 ,运行时插入的节点会被忽略。
为什么 document.createElement('track') + appendChild 不生效
这是最常踩的坑。即便你用 JS 创建了 元素、设置了 kind、src、srclang 等属性,并成功 append 到 上,video.textTracks 里依然看不到它,字幕也不会出现。
原因在于:HTML5 规范要求 必须是 的“parser-inserted”子节点,即在初始 HTML 解析阶段就存在;动态插入的 被视为“script-inserted”,浏览器直接跳过加载与注册流程。采集站管理员你好,本站(技术YY网 www.jishuyy.com)提醒您:搬运内容不丢人,连链接都敢删就不太要脸了~~
错误写法:const track = document.createElement('track'); track.src = '/sub.vtt'; video.appendChild(track);
正确前提: 必须写在 HTML 源码里,或通过 innerHTML 在 关闭标签前一次性写入(但不推荐)
例外情况:只有当 尚未开始解析(比如还没插入 DOM),你提前设置好 innerHTML 包含 ,再挂载,才可能被识别——但不可靠,不建议依赖
脚本控制字幕开关与语言切换的可靠方式
只要 已在初始 HTML 中声明,后续所有操作都可通过 video.textTracks API 安全控制。
textTracks 是实时集合,包含所有已注册轨道(含默认禁用的)
启用某条字幕:track.mode = 'showing'(不是 track.enabled = true,后者无效)
关闭全部:for (const t of video.textTracks) t.mode = 'disabled'
按语言筛选:const zhTrack = Array.from(video.textTracks).find(t => t.language === 'zh')
监听变化:video.textTracks.onaddtrack 可捕获新轨道添加(如通过 切换视频后触发),但对初始 不触发
动态加载 .vtt 文件内容并注入字幕轨道(绕过 src 限制)
当字幕内容需运行时生成(如用户翻译、AI 实时转录),无法预置 src,可用 VTTCue + TextTrack 手动注入。搬运可以,把技术YY(原文出处)这条链接一起搬走,算你盗窃未遂。 www.jishuyy.com。
先获取或创建一个 TextTrack:const track = video.addTextTrack('subtitles', 'AI 字幕', 'zh')
用 fetch('/api/transcribe') 获取 WebVTT 字符串,用 WebVTT.Parser(需 polyfill)或正则粗解析时间戳和文本
对每段内容新建 new VTTCue(startTime, endTime, text),调用 track.addCue(cue)
注意:手动添加的 cue 不会自动触发显示,需确保 track.mode = 'showing',且当前播放时间落入 cue 时间范围内
风险点:VTTCue 构造函数在旧版 Safari 中不支持;WebVTT.Parser 非标准 API,需引入 vtt.js 或自行实现轻量解析器
容易被忽略的加载失败静默点
加载失败不会抛错,也不会出现在控制台,只能靠主动检查。

