API

运行时配置

i18n 运行时配置选项。

一些选项可以通过 runtimeConfig 设置,这种方式使得在构建后使用环境变量覆盖这些选项成为可能。

使用方法

如果您想使用环境变量来更改 支持的选项,您必须在 runtimeConfig.public.i18n 中设置这些选项。

nuxt.config.ts
export default defineNuxtConfig({
    modules: ['@nuxtjs/i18n'],
    i18n: {
        // 保留您希望通过 `runtimeConfig` 设置的选项
        // baseUrl: 'https://example.com',
    },
    runtimeConfig: {
        public: {
            i18n: {
                baseUrl: 'https://example.com',
                domainLocales: {}
                // 其他选项 ...
            }
        }
    }
})

您可以在 Nuxt 文档 中阅读更多关于此如何工作的内容。

runtimeConfig 中仅支持 可序列化的值,通过这种方式设置的选项可能不支持所有可用类型(例如函数),因为使用默认配置时通常可以实现。
如果您希望支持其他选项,请提交一个描述您的用例的问题,或者提交一个 PR 以自己添加支持!

支持的选项

模块配置优先权较高,通过 runtimeConfig 设置的选项只有在未设置时才会使用。

这些选项可以使用 runtimeConfig 设置:

baseUrl

  • 键: NUXT_PUBLIC_I18N_BASE_URL

此运行时配置选项与 baseUrl 模块选项相同。

请注意,baseUrl 模块选项允许您设置函数,但由于限制,运行时配置不支持。

locales

  • 属性: locales[code].domain
  • 键: NUXT_PUBLIC_I18N_DOMAIN_LOCALES_{code}_DOMAIN

此运行时配置选项允许覆盖在 locales 模块选项中设置的域。