HTML中track元素的srclang属性怎么填才规范-html教程-PHP中文网

srclang 必须使用标准 BCP 47 语言标签（如 zh、zh-Hans、zh-Latn、en-US），不可填“中文”“pinyin”等非标准值；它是 kind="subtitles" 或 "captions" 的强制属性，缺失或错误将导致字幕不显示。

html中track元素的srclang属性怎么填才规范

srclang 必须用标准 BCP 47 语言标签，不是随便起名

填 srclang 不是写“中文”“English”或“pinyin”，而是必须用浏览器和辅助技术能识别的标准化语言代码。错填会导致字幕不进菜单、系统语言自动匹配失效、屏幕阅读器无法正确播报。

常见有效值包括：zh（简体中文）、zh-Hans（简体中文，更精确）、zh-Latn（汉语拼音，BCP 47 正式写法）、en-US、ja、ko、es。无效写法如：chinese、zh-CN（虽常见但非标准，部分旧浏览器可能 fallback 失败）、pinyin、zh-py、cn。

zh 和 zh-Hans 都可表示简体中文，但 zh 兼容性更好；若需区分繁简，优先用 zh-Hans / zh-Hant
拼音必须用 zh-Latn，这是 IETF RFC 5968 明确规定的转写变体标识，zh-Latn-pinyin 是冗余且不被支持的
地区子标签（如 -US）仅在需要区分方言/拼写时添加，en 已足够覆盖大多数英语字幕场景

srclang 是 subtitles 类型的强制属性，漏写就等于没字幕

只要 kind="subtitles"，srclang 就不是可选——它是 HTML5 规范强制要求的。不写或写空值（srclang=""），Chrome、Edge 会静默忽略该，Firefox 可能报警告但也不加载，控制台通常不报错，只表现为字幕菜单里根本看不到这一项。

注意：kind="captions" 同样要求 srclang；但 kind="chapters" 或 kind="metadata" 不需要它。

Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转

实现 Markdown↔ HTML 互转，支持导出 PDF，用于用户请求的文档格式转换。

下载

错误示例： → 缺 srclang，字幕不可见
正确写法：
多个同语言变体（如简中+拼音）必须用不同 srclang 区分，不能都写 zh

大小写、空格、BOM 都会影响 srclang 解析

srclang 值本身不区分大小写（ZH 和 zh 等效），但实际部署中要统一小写，避免和文件路径、CORS 配置等环节产生混淆。真正容易出问题的是它关联的 VTT 文件本身：如果 .vtt 文件带 UTF-8 BOM，或首行不是严格 WEBVTT（前后有空格、换行、注释），即使 srclang 填对了，整个轨道也会加载失败，且浏览器不会提示与 srclang 相关的错误。

VTT 文件必须以无 BOM 的 UTF-8 保存，首行为纯 WEBVTT（无空格、无注释、不加 // 或）
服务器需返回 Content-Type: text/vtt，Nginx/Apache 要显式配置 MIME 类型，否则 Safari 可能拒绝解析
本地开发勿用 file:// 协议打开，srclang 再规范也加载不了 VTT——必须起 HTTP 服务（如 python3 -m http.server）

srclang 和用户可见 label 没有绑定关系，别靠它猜显示名

srclang 是给浏览器和辅助技术用的机器可读语言标识，label 才是用户在右键字幕菜单里看到的文字。两者可以不同，比如 srclang="zh-Latn" 对应 label="汉语拼音"，或 srclang="en" 对应 label="English (UK)"。不要以为写了 srclang="zh"，浏览器就会自动显示“中文”——那完全取决于你写的 label 值。