i18n

用于国际化您的扩展的函数。您可以使用这些 API 从扩展包中的 locale 文件获取本地化字符串,了解浏览器的当前语言,以及了解其 Accept-Language 标头 的值。

有关使用此 API 的指南,请参阅 国际化 页面。

类型

i18n.LanguageCode

一个 语言标签,例如 "en-US""fr"

函数

i18n.detectLanguage()

使用 Compact Language Detector 检测提供的文本的语言。

i18n.getMessage()

获取指定消息的本地化字符串。

i18n.getAcceptLanguages()

获取浏览器的 accept-languages。这与浏览器使用的 locale 不同。要获取 locale,请使用 i18n.getUILanguage

i18n.getUILanguage()

获取浏览器的 UI 语言。这与 i18n.getAcceptLanguages 不同,后者返回用户偏好的语言。

i18n.getPreferredSystemLanguages()

返回操作系统偏好的 locales。

i18n.getSystemUILanguage()

返回操作系统的当前 UI locale。

扩展程序示例

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.i18n API。本文档源自 Chromium 代码中的 i18n.json

另见

  • 国际化:使用 WebExtension i18n 系统的指南。
  • 特定区域设置消息参考:扩展在名为 messages.json 的文件中提供特定区域设置的字符串。本文档描述了 messages.json 的格式。