Skip to content

Interface: ComponentCustomProperties

Component Custom Properties for Vue I18n

Signature

ts
export interface ComponentCustomProperties

Properties

NameTypeDescription
$i18nExportedGlobalComposerExported Global Composer instance

Methods

$d()

ts
$d(value: number | Date | string): string;

Datetime formatting

Parameters

NameTypeDescription
valuenumber | Date | stringA value, timestamp number or Date instance

Returns

string — formatted value

Tags

  • @remarks — If this is used in a reactive context, it will re-evaluate once the locale changes. In Composition API mode, the $d is injected by app.config.globalProperties. the input / output is the same as for Composer instance, and it work on global scope. About that details, see Composer#d.

$d()

ts
$d<
    Value extends number | Date | string = number,
    Key extends string = string,
    DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> =
      RemovedIndexResources<DefineDateTimeFormat>,
    Keys = IsEmptyObject<DefinedDateTimeFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(value: Value, key: Key | ResourceKeys): string;

Datetime formatting

Type Parameters

Name
Value extends number | Date | string = number
Key extends string = string
DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>
Keys = IsEmptyObject<DefinedDateTimeFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
valueValueA value, timestamp number or Date instance
keyKey | ResourceKeysA key of datetime formats

Returns

string — formatted value

Tags

  • @remarks — Overloaded $d. About details, see the $d remarks.

$d()

ts
$d<
    Value extends number | Date | string = number,
    Key extends string = string,
    DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> =
      RemovedIndexResources<DefineDateTimeFormat>,
    Keys = IsEmptyObject<DefinedDateTimeFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(value: Value, options: DateTimeOptions<Key | ResourceKeys>): string;

Datetime formatting

Type Parameters

Name
Value extends number | Date | string = number
Key extends string = string
DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>
Keys = IsEmptyObject<DefinedDateTimeFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
valueValueA value, timestamp number or Date instance
optionsDateTimeOptions<Key | ResourceKeys>An options

Returns

string — formatted value

Tags

  • @remarks — Overloaded $d. About details, see the $d remarks.

$d()

ts
$d<
    Value extends number | Date | string = number,
    Key extends string = string,
    DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> =
      RemovedIndexResources<DefineDateTimeFormat>,
    Keys = IsEmptyObject<DefinedDateTimeFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(value: Value, key: Key | ResourceKeys, locale: Locale): string;

Datetime formatting

Type Parameters

Name
Value extends number | Date | string = number
Key extends string = string
DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>
Keys = IsEmptyObject<DefinedDateTimeFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
valueValueA value, timestamp number or Date instance
keyKey | ResourceKeysA key of datetime formats
localeLocaleA locale, optional, override locale that global scope or local scope

Returns

string — formatted value

Tags

  • @remarks — Overloaded $d. About details, see the $d remarks.

$d()

ts
$d<
    Value extends number | Date | string = number,
    Key extends string = string,
    DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> =
      RemovedIndexResources<DefineDateTimeFormat>,
    Keys = IsEmptyObject<DefinedDateTimeFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never,
    OptionsType = DateTimeOptions<Key | ResourceKeys>
  >(value: Value, options: OptionsType, locale: Locale): IsPart<OptionsType> extends true ? Intl.DateTimeFormatPart[] : string;

Datetime formatting

Type Parameters

Name
Value extends number | Date | string = number
Key extends string = string
DefinedDateTimeFormat extends RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>
Keys = IsEmptyObject<DefinedDateTimeFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedDateTimeFormat]: DefinedDateTimeFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
OptionsType = DateTimeOptions<Key | ResourceKeys>

Parameters

NameTypeDescription
valueValueA value, timestamp number or Date instance
optionsOptionsTypeAn options
localeLocaleA locale, optional, override locale that global scope or local scope

Returns

IsPart<OptionsType> extends true ? Intl.DateTimeFormatPart[] : string — formatted value

Tags

  • @remarks — Overloaded $d. About details, see the $d remarks.

$n()

ts
$n(value: number): string;

Number formatting

Parameters

NameTypeDescription
valuenumberA number value

Returns

string — formatted value

Tags

  • @remarks — If this is used in a reactive context, it will re-evaluate once the locale changes. In Composition API mode, the $n is injected by app.config.globalProperties. the input / output is the same as for Composer instance, and it work on global scope. About that details, see Composer.n.

$n()

ts
$n<
    Key extends string = string,
    DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> =
      RemovedIndexResources<DefineNumberFormat>,
    Keys = IsEmptyObject<DefinedNumberFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(value: number, key: Key | ResourceKeys): string;

Number formatting

Type Parameters

Name
Key extends string = string
DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>
Keys = IsEmptyObject<DefinedNumberFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
valuenumberA number value
keyKey | ResourceKeysA key of number formats

Returns

string — formatted value

Tags

  • @remarks — Overloaded $n. About details, see the $n remarks.

$n()

ts
$n<
    Key extends string = string,
    DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> =
      RemovedIndexResources<DefineNumberFormat>,
    Keys = IsEmptyObject<DefinedNumberFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never,
    OptionsType = NumberOptions<Key | ResourceKeys>
  >(value: number, options: OptionsType): IsPart<OptionsType> extends true ? Intl.NumberFormatPart[] : string;

Number formatting

Type Parameters

Name
Key extends string = string
DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>
Keys = IsEmptyObject<DefinedNumberFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
OptionsType = NumberOptions<Key | ResourceKeys>

Parameters

NameTypeDescription
valuenumberA number value
optionsOptionsTypeAn options, see the NumberOptions

Returns

IsPart<OptionsType> extends true ? Intl.NumberFormatPart[] : string — formatted value

Tags

  • @remarks — Overloaded $n. About details, see the $n remarks.

$n()

ts
$n<
    Key extends string = string,
    DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> =
      RemovedIndexResources<DefineNumberFormat>,
    Keys = IsEmptyObject<DefinedNumberFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(value: number, key: Key | ResourceKeys, locale: Locale): string;

Number formatting

Type Parameters

Name
Key extends string = string
DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>
Keys = IsEmptyObject<DefinedNumberFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
valuenumberA number value
keyKey | ResourceKeysA key of number formats
localeLocaleA locale, optional, override locale that global scope or local scope

Returns

string — formatted value

Tags

  • @remarks — Overloaded $n. About details, see the $n remarks.

$n()

ts
$n<
    Key extends string = string,
    DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> =
      RemovedIndexResources<DefineNumberFormat>,
    Keys = IsEmptyObject<DefinedNumberFormat> extends false
      ? PickupFormatPathKeys<{
          [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never,
    OptionsType = NumberOptions<Key | ResourceKeys>
  >(value: number, options: OptionsType, locale: Locale): IsPart<OptionsType> extends true ? Intl.NumberFormatPart[] : string;

Number formatting

Type Parameters

Name
Key extends string = string
DefinedNumberFormat extends RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>
Keys = IsEmptyObject<DefinedNumberFormat> extends false ? PickupFormatPathKeys<{ [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
OptionsType = NumberOptions<Key | ResourceKeys>

Parameters

NameTypeDescription
valuenumberA number value
optionsOptionsTypeAn options, see the NumberOptions
localeLocaleA locale, optional, override locale that global scope or local scope

Returns

IsPart<OptionsType> extends true ? Intl.NumberFormatPart[] : string — formatted value

Tags

  • @remarks — Overloaded $n. About details, see the $n remarks.

$rt()

ts
$rt(message: MessageFunction<VueMessageType> | VueMessageType): string;

Resolve locale message translation

Parameters

NameTypeDescription
messageMessageFunction<VueMessageType> | VueMessageTypeA target locale message to be resolved. You will need to specify the locale message returned by $tm.

Returns

string — translated message

Tags

  • @remarks — If this is used in a reactive context, it will re-evaluate once the locale changes. In Composition API mode, the $rt is injected by app.config.globalProperties. the input / output is the same as for Composer, and it work on global scope. About that details, see Composer#rt.

$rt()

ts
$rt(message: MessageFunction<VueMessageType> | VueMessageType, plural: number, options?: TranslateOptions): string;

Resolve locale message translation for plurals

Parameters

NameTypeDescription
messageMessageFunction<VueMessageType> | VueMessageTypeA target locale message to be resolved. You will need to specify the locale message returned by $tm.
pluralnumberWhich plural string to get. 1 returns the first one.
optionsTranslateOptionsAdditional options for translation (optional)

Returns

string — Translated message

Tags

  • @remarks — Overloaded $rt. About details, see the $rt remarks.

$rt()

ts
$rt(message: MessageFunction<VueMessageType> | VueMessageType, list: unknown[], options?: TranslateOptions): string;

Resolve locale message translation for list interpolations

Parameters

NameTypeDescription
messageMessageFunction<VueMessageType> | VueMessageTypeA target locale message to be resolved. You will need to specify the locale message returned by $tm.
listunknown[]A values of list interpolation.
optionsTranslateOptionsAdditional options for translation (optional)

Returns

string — Translated message

Tags

  • @remarks — Overloaded $rt. About details, see the $rt remarks.

$rt()

ts
$rt(message: MessageFunction<VueMessageType> | VueMessageType, named: NamedValue, options?: TranslateOptions): string;

Resolve locale message translation for named interpolations

Parameters

NameTypeDescription
messageMessageFunction<VueMessageType> | VueMessageTypeA target locale message to be resolved. You will need to specify the locale message returned by $tm.
namedNamedValueA values of named interpolation.
optionsTranslateOptionsAdditional options for translation (optional)

Returns

string — Translated message

Tags

  • @remarks — Overloaded $rt. About details, see the $rt remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key

Returns

string — translation message

Tags

  • @remarks — If this is used in a reactive context, it will re-evaluate once the locale changes. In Composition API mode, the $t is injected by app.config.globalProperties. the input / output is the same as for Composer, and it work on global scope. About that details, see Composer#t.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, plural: number): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
pluralnumberA choice number of plural

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, plural: number, options: TranslateOptions): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
pluralnumberWhich plural string to get. 1 returns the first one.
optionsTranslateOptionsAn options, see the TranslateOptions

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, defaultMsg: string): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
defaultMsgstringA default message to return if no translation was found

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, defaultMsg: string, options: TranslateOptions): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
defaultMsgstringA default message to return if no translation was found
optionsTranslateOptionsAn options, see the TranslateOptions

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, list: unknown[]): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
listunknown[]A values of list interpolation

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, list: unknown[], plural: number): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
listunknown[]A values of list interpolation
pluralnumberA choice number of plural

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, list: unknown[], defaultMsg: string): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
listunknown[]A values of list interpolation
defaultMsgstringA default message to return if no translation was found

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, list: unknown[], options: TranslateOptions): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
listunknown[]A values of list interpolation
optionsTranslateOptionsAn options, see the TranslateOptions

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, named: NamedValue): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
namedNamedValueA values of named interpolation

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, named: NamedValue, plural: number): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
namedNamedValueA values of named interpolation
pluralnumberA choice number of plural

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, named: NamedValue, defaultMsg: string): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
namedNamedValueA values of named interpolation
defaultMsgstringA default message to return if no translation was found

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$t()

ts
$t<
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: ResourceKeys | (string & {}) | number, named: NamedValue, options: TranslateOptions): string;

Locale message translation

Type Parameters

Name
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyResourceKeys | (string & {}) | numberA target locale message key
namedNamedValueA values of named interpolation
optionsTranslateOptionsAn options, see the TranslateOptions

Returns

string — translation message

Tags

  • @remarks — Overloaded $t. About details, see the $t remarks.

$te()

ts
$te<
    Key extends string,
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: Key | ResourceKeys, locale?: Locale): boolean;

Translation message exist

Type Parameters

Name
Key extends string
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyKey | ResourceKeysA target locale message key
localeLocaleA locale, optional, override locale that global scope or local scope (optional)

Returns

boolean — If found locale message, true, else false, Note that false is returned even if the value present in the key is not translatable.

Tags

  • @remarks — About that details, see VueI18n#te or Composer#te.

$tm()

ts
$tm<
    Key extends string,
    DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> =
      RemovedIndexResources<DefineLocaleMessage>,
    Keys = IsEmptyObject<DefinedLocaleMessage> extends false
      ? JsonPaths<{
          [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K]
        }>
      : never,
    ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never
  >(key: Key | ResourceKeys): LocaleMessageValue<VueMessageType> | {};

Locale messages getter

Type Parameters

Name
Key extends string
DefinedLocaleMessage extends RemovedIndexResources<DefineLocaleMessage> = RemovedIndexResources<DefineLocaleMessage>
Keys = IsEmptyObject<DefinedLocaleMessage> extends false ? JsonPaths<{ [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K] }> : never
ResourceKeys extends Keys = IsNever<Keys> extends false ? Keys : never

Parameters

NameTypeDescription
keyKey | ResourceKeysA target locale message key

Returns

LocaleMessageValue<VueMessageType> | {} — locale messages

Tags

  • @remarks — In Composition API mode, the $tm is injected by app.config.globalProperties. the input / output is the same as for Composer instance, and it work on global scope. About that details, see Composer.tm. Based on the current locale, locale messages will be returned from Composer instance messages. If you change the locale, the locale messages returned will also correspond to the locale. If there are no locale messages for the given key in the composer instance messages, they will be returned with fallbacking.

Tags

  • @VueI18nInjection

Released under the MIT License.