Uploaded image for project: 'Cristal'
  1. Cristal
  2. CRISTAL-396

Upgrade to vue-i18n 11.0.1

    XMLWordPrintable

Details

    • Task
    • Resolution: Fixed
    • Major
    • 0.14
    • None
    • None
    • None
    • Unknown
    • N/A
    • N/A

    Description

      Release Notes

      intlify/vue-i18n (vue-i18n)

      v11.0.1

      Compare Source

      This changelog is generated by GitHub Releases

      What's Changed

      ⚡ Improvement Features

      Full Changelog: intlify/vue-i18n@v11.0.0...v11.0.1

      v11.0.0

      Compare Source

      This changelog is generated by GitHub Releases

      What's Changed

      Deprecate Legacy API mode

      The Legacy API mode was the API mode compatible with v8 for Vue 2. When v9 was released, the Legacy API was provided to smooth the migration from v8 to v9.

      Legacy API mode will be deprecated in v11, as previous vue-i18n releases have already provided the following to support migration to Composition API mode

      • Migration from Legacy API mode to Composition API mode, see the docs
      • Composition API usage, see the docs

      For compatibility, Legacy API mode still works in v11, but will be removed entirely in v12, so Legacy API mode will not work after that version.

      Deprecate Custom Directive v-t

      The advantage of v-t was that it could optimize performance using the vue compiler transform and the pre-translation of vue-i18n-extension.

      This feature was supported from Vue 2.
      About details see the blog article

      In Vue 3, due to the Composition API, the pre-translation of vue-i18n-extension is now limited only for global scope.

      In addition, Vue 3 Virtual DOM optimization has been introduced, and the optimization provided by vue-i18n-extension is no longer very effective. We need to require settings for SSR, the benefits of using v-t have disappeared. And DX of templates using v-t is not good. Custom directives do not work with key completion in editors (e.g. vscode).

      For compatibility, v-t mode still works in v11, but will be removed entirely in v12, so v-t will not work after that version.

      Drop tc and $tc for Legacy API mode

      These APIs had already deprecated in warning about being dropped in v11. docs says

      Vue I18n maintenance Status

      Vue I18n v8 is no longer supported after 2025. Vue I18n v9 and Vue I18n v10 is in maintenance mode after 2025 July.

      With the release of Vue I18n v11, that version will become mainstream.

      The maintenance detail status of Vue I18n v9 and Vue I18n v10 is as follows:

      You can check the maintenance status on the docs

      ❗ Braeking Changes
      ⚡ Improvement Features
      🔒 Security Fixes
      📝️ Documentations

      👋 New Contributors

      Full Changelog: intlify/vue-i18n@v10.0.4...v11.0.0

      Attachments

        Activity

          People

            mleduc Manuel Leduc
            mleduc Manuel Leduc
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: