加了 kind="subtitles" 仍不可选,是因为浏览器仅原生支持 kind="subtitles" 和 kind="captions",拼写错误、大小写混用、漏写 kind 或误用其他值(如 "descriptions")会导致轨道未注册进 textTracks。

为什么加了 kind="subtitles" 还是不可选
浏览器只对 kind="subtitles" 和 kind="captions" 提供原生字幕菜单(右键「字幕」或控件栏「CC」按钮),其他值如 "subtitle"、"subtitles "(末尾空格)、"chapters" 会被静默忽略——textTracks 里根本不会出现,更别说可选了。
常见错误包括:
-
kind拼错或大小写混用(如Kind="Subtitles") - 漏写
kind属性(不是可选,是必须) - 误用
kind="descriptions"或kind="metadata"—— 它们不参与用户可见的字幕切换
srclang 和 label 怎么配才真正可区分
srclang 是浏览器匹配系统语言的唯一依据,label 是用户在菜单里看到的唯一名称。两者缺一不可,且不能矛盾。
必须做到:
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
srclang用标准 BCP 47 码,如"zh"、"en-US"、"ja";写成"zh-CN"时,若用户系统语言是"zh",部分浏览器(如 Safari)可能不自动启用 -
label必须填写,且在同一<video></video>中不能重复;哪怕srclang相同(比如两条中文轨道),也要靠label区分,例如label="中文(官方)"和label="中文(AI生成)" - 不要用
label="Chinese"配srclang="zh"—— 用户看到的是 label,不是 srclang;中英文混用会让多语言用户困惑
为什么 default 不等于“默认可选”
default 属性不是开关,它只是个弱提示:仅当用户首次访问、从未点过字幕按钮、且所有加载条件都满足时,浏览器才可能启用该轨道。现实中极易失效。
真正让用户“可选”的关键,是让每条 <track></track> 都成功注册进 video.textTracks。常见阻断点:
-
src返回 404 或 CORS 错误 → 轨道加载失败,textTracks长度不足预期 - 服务器没返回
Content-Type: text/vtt→ Chrome/Firefox 可能静默跳过 - VTT 文件带 BOM 或首行不是顶格
WEBVTT→ 解析失败,轨道状态为NOT_LOADED - 移动端 Safari 在私密模式下直接不解析
<track></track>标签 →textTracks.length === 0,菜单自然不出现
如何验证是否真“可选”
别只看播放器界面有没有「CC」按钮。打开控制台,执行以下检查:
console.log(video.textTracks.length); // 应等于你写的 <track> 数量 Array.from(video.textTracks).forEach(t => console.log(t.kind, t.srclang, t.label, t.mode) );
如果某条轨道的 mode 是 "disabled",说明它已注册成功、用户可手动启用;如果是 "notloaded" 或根本不在列表里,就不是“不可选”,而是“没加载进来”。
特别注意:iOS Safari 默认隐藏原生字幕菜单,即使 textTracks 正常,你也得自己用 JS 渲染切换 UI 并调用 t.mode = "showing" —— 它不响应 default,也不暴露「字幕」右键菜单。


















