扩展 Vue

Vue 构造函数选项

i18n

• 类型：I18nOptions基于组件的本地化选项

• 请参阅：VueI18n 类构造函数选项

Vue 注入方法

$t

• 参数：

  • {Path} key：必填
  • {Locale} locale：可选
  • {Array | Object} values：可选
• 返回值：TranslateResult

本地化语言环境信息 key，在本地化时组件的语言环境信息优先于全局语言环境信息。如果未指定组件的语言环境信息，就使用全局语言环境信息进行本地化。如果你指定了 locale 参数，则使用 locale 提供的语言环境进行本地化。如果你为列表/格式化的语言环境信息指定了 key，就必须同时指定 values。有关 values 的详细信息，请参阅格式化。

提示

注意，你需要在生命周期方法中保证上下文是组件实例 (例如在 data 选项中，const $t = this.$t.bind(this))。

$tc

• 参数：

  • {Path} key：必填
  • {number} choice：可选，默认为 1
  • {Locale} locale：可选
  • {string | Array | Object} values：可选
• 返回值：TranslateResult

以复数形式将语言环境信息 key 本地化。在本地化时组件的语言环境信息优先于全局语言环境信息。如果未指定组件的语言环境信息，就使用全局语言环境信息进行本地化。如果你指定了 locale 参数，则使用 locale 提供的语言环境进行本地化。如果将 values 指定为字符串，则该字符串会作为语言环境信息进行本地化。如果将 values 指定为 Array 或 Object，则格式必须为 $t 的 values。

提示

注意，你需要在生命周期方法中保证上下文是组件实例 (例如在 data 选项中，const $tc = this.$tc.bind(this))

$te

• 参数：

  • {Path} key：必填
  • {Locale} locale：可选
• 返回值：boolean

检查 key 是否存在。在 Vue 实例中，如果未指定组件语言环境信息，则使用全局语言环境信息。如果指定了 locale，则使用 locale 的语言环境。

提示

注意，你需要在生命周期方法中保证上下文是组件实例 (例如在 data 选项中，const $te = this.$te.bind(this))。

$d

🆕 7.0 新增

• 参数：

  • {number | Date} value：必填
  • {Path | Object} key：可选
  • {Locale | Object} locale：可选
• 返回值：DateTimeFormatResult

将日期时间 value 以 key 的格式本地化。日期时间格式 key 需要注册到 VueI18n 类的 dateTimeFormats 选项，并依赖于 VueI18n 构造函数的 locale 选项。如果要指定 locale 参数，它将优先于 VueI18n 构造函数的 locale 选项。

如果 dateTimeFormats 选项中不存在日期时间格式的 key，则根据 VueI18n 构造函数的 fallbackLocale 选项回退。

提示

注意，你需要在生命周期方法中保证上下文是组件实例 (例如在 data 选项中，const $n = this.$n.bind(this))。

$n

🆕 7.0 新增

• 参数：

  • {number} value：必填
  • {Path | Object} key：可选
  • {Locale} locale：可选
• 返回值：NumberFormatResult

将数字 value 以 key 的格式本地化。数字格式 key 需要注册到 VueI18n 类的 numberFormats 选项，并依赖于 VueI18n 构造函数的 locale 选项。如果要指定 locale 参数，它将优先于 VueI18n 构造函数的 locale 选项。

如果 numberFormats 选项中不存在用数字格式 key，则根据 VueI18n 构造函数的 fallbackLocale 选项回退。

如果第二个 key 参数指定为对象，则它应具有以下属性：

• key {Path}：可选，数字格式
• locale {Locale}：可选，语言环境
• style {string}：可选，数字格式选项
• currency {string}：可选，数字格式选项
• currencyDisplay {string}：可选，数字格式选项
• useGrouping {string}：可选，数字格式选项
• minimumIntegerDigits {string}：可选，数字格式选项
• minimumFractionDigits {string}：可选，数字格式选项
• maximumFractionDigits {string}：可选，数字格式选项
• minimumSignificantDigits {string}：可选，数字格式选项
• maximumSignificantDigits {string}：可选，数字格式选项
• localeMatcher {string}：可选，数字格式选项
• formatMatcher {string}：可选，数字格式选项任何指定数字的格式选项将优先于 VueI18n 构造函数的 numberFormats。

提示

注意，你需要在生命周期方法中保证上下文是组件实例 (例如在 data 选项中，const $d = this.$d.bind(this))。

注入属性

$i18n

• 类型：I18n

• 只读

若已经指定了 VueI18n 实例，则将其返回。

如果在组件选项中指定了 i18n 选项，则可以在组件上获得 VueI18n 实例，否则，你将获得 VueI18n 的根实例。