选项

杂项

各种选项。

experimental

  • type: object
  • default: { localeDetector: '', switchLocalePathLinkSSR: false, autoImportTranslationFunctions: false }

支持的属性:

  • localeDetector(默认:'') - 指定在服务器端每个请求调用的语言检测器。需要指定定义语言检测器的文件路径。
    关于如何定义语言检测器,请参见 defineI18nLocaleDetector API
  • switchLocalePathLinkSSR(默认:false) - 更改动态路由参数的跟踪和内部更新方式,改善使用 SwitchLocalePathLink 组件时的语言切换 SSR。
  • autoImportTranslationFunctions(默认:false) - 当使用时,在 <script setup> 中自动导入/初始化 $t$rt$d$n$tm$te 函数。
    此功能依赖于 Nuxt 的自动导入,如果已禁用,则无法使用。

customBlocks

  • type: object
  • default: { defaultSFCLang: 'json', globalSFCScope: false }

配置 SFC 的 i18n 自定义块。

支持的属性:

  • defaultSFCLang(默认:'json') - 指定所有内联 i18n 自定义块的内容。有关详细信息,请参见 此处
  • globalSFCScope(默认:false) - 是否在全局范围内包含所有 SFC 的 i18n 自定义块。有关详细信息,请参见 此处

types

  • type: stringcompositionlegacy
  • default: composition

强制使用的 API 风格的类型定义。如果设置为 composition,则支持 Vue I18n 和 @nuxtjs/i18n 提供的组合 API 类型;否则为 legacy,支持选项 API 类型。

如果无法检测到 Nuxt 配置更改,您可能需要运行 nuxi prepare

debug

  • type: boolean
  • default: false

是否使用 @nuxtjs/i18n 调试模式。如果为 true,则日志将输出到控制台。

此选项的目的是帮助识别 @nuxtjs/i18n 的任何问题。在生产环境中不要启用此选项,因为它并未针对生产环境进行优化。

parallelPlugin

  • type: boolean
  • default: false

将插件设置为 parallel。请参阅 nuxt 插件加载策略

restructureDir

  • type: string | undefined
  • default: undefined

可用于配置用于解析 i18n 文件的目录,默认在 v9 版本中将设置为 i18n

设置此值还将更改 langDir 的默认值,如果未设置,该值为 locales,这是 v9 中的新默认值。