manifest lang / dir 浏览器支持

发布于 2026-09-04更新于 2026-09-14作者 Carey Gill · 编辑流程

Web App Manifest 的 dir 与 lang 成员为清单中可本地化的成员——name、 short_name 和 icons——设置默认的文本方向和语言。

浏览器支持

MDN 的清单参考文档指出，目前 dir、lang 与 iarc_rating_id 尚未被任何浏览器实现。由于没有浏览器对这两个成员做出响应，也就没有可引用的逐浏览器支持表。

如何使用

你仍然可以在清单中声明 dir 和 lang——它们是规范中合法的可选成员：

{
  "name": "SuperSausage",
  "dir": "rtl",
  "lang": "ar",
  "start_url": "."
}

如何在运行时检测

根据 MDN 的说明，dir、lang 和 iarc_rating_id 尚未被浏览器实现。

function applyDocumentLocale(lang, dir) {
  // 浏览器尚未实现清单的 `dir`/`lang` 成员。
  if (typeof document === 'undefined') {
    return;
  }
  document.documentElement.lang = lang;
  document.documentElement.dir = dir;
}

实践清单

不要依赖清单的 dir 或 lang 成员来控制方向或语言——MDN 指出两者均未被任何浏览器实现。
清单的 dir/lang 成员与文档自身的 <html dir>/<html lang> 属性是相互独立的；声明其中一个并不会设置另一个。
即使 MDN 指出目前没有浏览器实现它们，在清单中声明 dir/lang 仍然符合规范。

下一步

← 返回兼容性浏览器。