Skip to content

I18n

Chrome DocsFirefox Docs

此页面讨论了如何使用 vanilla browser.i18n API 设置国际化,并提到了如果需要使用其他库的一些替代方案。

语法

  1. 在 manifest 中添加 default_locale

    ts
    export default defineConfig({
      manifest: {
        default_locale: 'en',
      },
    });
  2. public/ 目录中创建 _locales 目录下的 messages.json 文件:

    html
    📂 {srcDir}/
       📂 public/
          📂 _locales/
             📂 en/
                📄 messages.json
             📂 de/
                📄 messages.json
             📂 ko/
                📄 messages.json
    jsonc
    // public/_locales/en/messages.json
    {
      "helloWorld": {
        "message": "Hello world!",
      },
    }
  3. 获取翻译:

    ts
    browser.i18n.getMessage('helloWorld');
  4. 可选: 对外扩展名和描述进行翻译:

json
{
  "extName": {
    "message": "..."
  },
  "extDescription": {
    "message": "..."
  },
  "helloWorld": {
    "message": "Hello world!"
  }
}
ts
export default defineConfig({
  manifest: {
    name: '__MSG_extName__',
    description: '__MSG_extDescription__',
    default_locale: 'en',
  },
});