intlify/vue-i18n v9.0.0-alpha.1

on GitHub

v9.0.0-alpha.1 (2020-04-07)

⭐ New Features

Composable API

New style API for Vue 3. See the following docs:

• createI18nComposer
• I18nComposerOptions
• I18nComposer
• useI18n

🍭 Examples

See the examples directory.

The examples are offered that use the following two API styles:

• composable
  • new vue-i18n API optimized for Vue 3. details about API
• legacy
  • vue-i18n API almost compatible with vue-i18n v8.x

❗ Known issues

💥 Breaking changes compared to vue-i18n v8.x

• API
  • The return value of $t and t methods is string only. object and array values ​​are no longer returned.
  • The return value of $tc and tc methods is string only. object and array values ​​are no longer returned.
  • VueI18n class cannot used with new. It can only be used via the $i18n property of Vue instance.
    • In vue-i18n-next, by replacing new VueI18n with createI18n, you can use existing VueI18n options as they are.
    • See the examples/legacy directory.
  • VueI18n.prototype.getChoiceIndex
    • -> Legacy API style: pluralizationRules option of createI18n factory function (like new VueI18n(...))
    • -> Compsable API style: pluralRules option of createI18nComposer facatory function
  • VueI18n.version -> import { VERSION } from 'vue-i18n'
  • VueI18n.availabilities -> import { availabilities } from 'vue-i18n'
  • See the details here

⚡ Improvements

• See the vue-i18n issues that labeld with Status: Ready

🔨 Missing features

• imporve fallbackLocale or fallbackLocales (related vue-i18n issue)
• <i18n> custom block supporting for SFC
• v-t directive
• preserveDirectiveContent option (depend on v-t)
• Compoonent interpolation with <i18n> component
• Number custom formatting with <i18n-n> component
• HTML format suppression with warnHtmlInMessage option
• SSR
• Custom formatting
• Tooling
  • vue-cli-plugin-i18n
  • @intlify/vue-i18n-loader
  • @intlify/rollup-plugin-vue-i18n
  • @intlify/vue-i18n-extensions
  • @intlify/eslint-plugin-vue-i18n

💿 Installation

npm

npm install --save vue-i18n@next

yarn

yarn add vue-i18n@next

Committers: 1

• kazuya kawaguchi (@kazupon)