Skip to content

Commit 46cea82

Browse files
committed
docs: update changelog
1 parent 7e38222 commit 46cea82

File tree

1 file changed

+42
-2
lines changed

1 file changed

+42
-2
lines changed

CHANGELOG.md

+42-2
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,47 @@ This changelog is generated by [GitHub Releases](https://github.com/intlify/vue-
66

77
## What's Changed
88

9-
### 💥 Breaking Changes
9+
### Deprecate Legacy API mode
10+
11+
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.
12+
13+
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
14+
15+
- Migration from Legacy API mode to Composition API mode, see the [docs](https://vue-i18n.intlify.dev/guide/migration/vue3.html)
16+
- Composition API usage, see the [docs](https://vue-i18n.intlify.dev/guide/advanced/composition.html)
17+
18+
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.
19+
20+
### Deprecate Custom Directive `v-t`
21+
22+
The advantage of `v-t` was that it could optimize performance using the vue compiler transform and the pre-translation of `vue-i18n-extension`.
23+
24+
This feature was supported from Vue 2.
25+
About details see the blog [article](https://medium.com/@kazu_pon/performance-optimization-of-vue-i18n-83099eb45c2d)
26+
27+
In Vue 3, due to the Composition API, the pre-translation of [`vue-i18n-extension`](https://github.com/intlify/vue-i18n-extensions) is now limited only for global scope.
28+
29+
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).
30+
31+
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.
32+
33+
### Drop `tc` and `$tc` for Legacy API mode
34+
35+
These APIs had already deprecated in warning about being dropped in v11. docs [says](https://vue-i18n.intlify.dev/guide/migration/breaking10.html#deprecate-tc-and-tc-for-legacy-api-mode)
36+
37+
### Vue I18n maintenance Status
38+
39+
Vue I18n v8 is no longer supported after 2025. Vue I18n v9 is in maintenance mode after 2025.
40+
41+
With the release of Vue I18n v11, that version will become mainstream.
42+
43+
The maintenance detail status of Vue I18n v9 and Vue I18n v10 is as follows:
44+
45+
<img src="https://raw.githubusercontent.com/intlify/vue-i18n/master/docs/public/lifecycle2025.svg" />
46+
47+
You can check the maintenance status on the [docs](https://vue-i18n.intlify.dev/guide/maintenance.html)
48+
49+
### ❗ Braeking Changes
1050

1151
- feat!: deprecate Legacy API mode by @kazupon in https://github.com/intlify/vue-i18n/pull/2016
1252
- breaking: drop `$tc` and `tc` by @kazupon in https://github.com/intlify/vue-i18n/pull/2017
@@ -33,7 +73,7 @@ This changelog is generated by [GitHub Releases](https://github.com/intlify/vue-
3373
- Fix another typo by @shaedrich in https://github.com/intlify/vue-i18n/pull/2041
3474
- docs: add maintenance status by @kazupon in https://github.com/intlify/vue-i18n/pull/2044
3575

36-
## New Contributors
76+
## 👋 New Contributors
3777

3878
- @chrissyast made their first contribution in https://github.com/intlify/vue-i18n/pull/2003
3979
- @Sammuel09 made their first contribution in https://github.com/intlify/vue-i18n/pull/1998

0 commit comments

Comments
 (0)