default 属性仅是弱信号,不控制字幕开关;真正控制显隐的是 textTracks.mode,需在 loadedmetadata 后设为 "disabled" 才生效。

default 属性根本不会“关闭”轨道,它只可能“尝试启用”
加了 default 的 标签,浏览器不会因为它存在就默认显示字幕;更不会因为删掉它就“关闭默认轨道”——default 本身不控制开关状态,它只是个弱信号,且只在极少数条件下起效。一旦用户点过一次字幕按钮(哪怕只是打开又关掉),这个信号就永久失效。你看到字幕开着,大概率是用户上次手动选的,不是 default 在起作用。
真正能关闭字幕轨道的只有 textTracks.mode
所有字幕轨道的显隐,最终由每个 TextTrack 实例的 mode 属性决定:
-
track.mode = "disabled"→ 彻底关闭,不加载、不渲染、不触发事件 -
track.mode = "hidden"→ 加载但不显示(可用于预加载) -
track.mode = "showing"→ 启用并实时渲染(唯一可见状态)
注意:mode 必须在 track.readyState === 2(即 loaded)后设置才有效;否则静默失败。常见错误是 DOM 加载完就立刻遍历 video.textTracks 并设 mode,但此时轨道还没加载完成,textTracks 里可能为空或 readyState 为 0。
如何批量关闭所有字幕轨道
如果你要确保页面加载后字幕默认不显示(比如做学习平台、避免干扰),别依赖 default,直接用 JS 清空:
实现 Markdown↔ HTML 互转,支持导出 PDF,用于用户请求的文档格式转换。
video.addEventListener('loadedmetadata', () => {
Array.from(video.textTracks)
.filter(track => track.kind === 'subtitles')
.forEach(track => track.mode = 'disabled');
});
关键点:
- 必须监听
loadedmetadata,不能用DOMContentLoaded或load - 只过滤
kind === "subtitles",避免误关captions或descriptions - 不需要检查
srclang或label,只要它是字幕类轨道,就统一关掉
优酷等第三方播放器的字幕关不了?那是你没找对地方
优酷、腾讯视频等平台的字幕不是走 HTML5 原生 轨道,而是自家 JS 播放器层渲染的。你操作 video.textTracks 完全无效。这类场景下:
- PC 端唯一稳定方式:等播放器加载完成,找到带
data-role="subtitle-toggle"或类似 class 的按钮,模拟点击 - 嵌入 iframe 场景:优先加 URL 参数,如
https://player.youku.com/embed/XXXX?showCaption=0 - 不要试图用
display: none隐藏字幕容器——它们通常用 canvas 或绝对定位 div 实现,DOM 结构不固定,容易失效
原生 的 default 是个历史包袱,它的语义模糊、行为不可控、兼容性差。真要控制字幕,默认关闭比默认开启更容易做到,也更符合可访问性原则——让用户自己决定是否开启,而不是替他们做主。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










