Skip to content
This repository was archived by the owner on Aug 8, 2022. It is now read-only.

Commit 43adcd4

Browse files
wxsmsJinjiang
andauthored
docs: Update introduction.md (#675)
Co-authored-by: Jinjiang <zhaojinjiang@me.com>
1 parent 0511797 commit 43adcd4

File tree

3 files changed

+36
-36
lines changed

3 files changed

+36
-36
lines changed

src/guide/migration/introduction.md

Lines changed: 33 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
- [用于迁移的构建版本](#用于迁移的构建版本)
1111
- [值得注意的新特性](#值得注意的新特性)
1212
- [非兼容的变更](#非兼容的变更)
13-
- [支持的库](#官方支持的库)
13+
- [官方的支持库](#官方的支持库)
1414

1515
## 概览
1616

@@ -42,89 +42,89 @@
4242

4343
## 用于迁移的构建版本
4444

45-
如果你有基于 Vue 2 的项目或者库,它要升级到 Vue 3,我们提供了与 Vue 2 兼容 API Vue 3 构建版本,查看[用于迁移的构建版本](./migration-build.html)获取完整的细节
45+
如果你打算要将一个基于 Vue 2 的项目或者库升级到 Vue 3,我们提供了一个与 Vue 2 API 兼容的 Vue 3 构建版本,详情见[用于迁移的构建版本](./migration-build.html)
4646

4747
## 值得注意的新特性
4848

49-
Vue 3 中需要关注的一些新功能包括
49+
Vue 3 中一些需要关注的新功能包括
5050

5151
- [组合式 API](/guide/composition-api-introduction.html)
5252
- [Teleport](/guide/teleport.html)
5353
- [片段](/guide/migration/fragments.html)
5454
- [触发组件选项](/guide/component-custom-events.html)
55-
- [来自 `@vue/runtime-core``createRenderer` API](https://github.com/vuejs/vue-next/tree/master/packages/runtime-core) 创建自定义渲染器
56-
- [单文件组件组合式 API 语法糖 (`<script setup>`)](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0040-script-setup.md) <Badge text="实验性" type="warning" />
57-
- [单文件组件状态驱动的 CSS 变量 (`<style>` 中的 `v-bind`)](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0043-sfc-style-variables.md) <Badge text="实验性" type="warning" />
55+
- [来自 `@vue/runtime-core``createRenderer` API](https://github.com/vuejs/vue-next/tree/master/packages/runtime-core),用于创建自定义渲染器
56+
- [单文件组件组合式 API 语法糖 (`<script setup>`)](/api/sfc-script-setup.html)
57+
- [单文件组件状态驱动的 CSS 变量 (`<style>` 中的 `v-bind`)](/api/sfc-style.html#状态驱动的动态-css)
5858
- [SFC `<style scoped>` 现在可以包含全局规则或只针对插槽内容的规则](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0023-scoped-styles-changes.md)
5959
- [Suspense](/guide/migration/suspense.html) <Badge text="实验性" type="warning" />
6060

6161
## 非兼容的变更
6262

63-
下面列出了从 2.x 开始的重大更改
63+
下面列出了从 2.x 开始的非兼容的变更
6464

6565
### 全局 API
6666

6767
- [全局 Vue API 已更改为使用应用程序实例](/guide/migration/global-api.html)
68-
- [全局和内部 API 已经被重构为可 tree-shakable](/guide/migration/global-api-treeshaking.html)
68+
- [全局和内部 API 已经被重构为支持 tree-shake](/guide/migration/global-api-treeshaking.html)
6969

7070
### 模板指令
7171

72-
- [组件上 `v-model` 用法已更改,替换 `v-bind.sync`](/guide/migration/v-model.html)
73-
- [`<template v-for>` 和非 `v-for` 节点上 `key` 用法已更改](/guide/migration/key-attribute.html)
72+
- [组件上 `v-model` 用法已更改,以替换 `v-bind.sync`](/guide/migration/v-model.html)
73+
- [`<template v-for>` 和非 `v-for` 节点上的 `key` 用法已更改](/guide/migration/key-attribute.html)
7474
- [在同一元素上使用的 `v-if``v-for` 优先级已更改](/guide/migration/v-if-v-for.html)
7575
- [`v-bind="object"` 现在排序敏感](/guide/migration/v-bind.html)
7676
- [`v-on:event.native` 修饰符已移除](./v-on-native-modifier-removed.md)
7777
- [`v-for` 中的 `ref` 不再注册 ref 数组](/guide/migration/array-refs.html)
7878

7979
### 组件
8080

81-
- [只能使用普通函数创建功能组件](/guide/migration/functional-components.html)
82-
- [`functional` 属性在单文件组件 (SFC) `<template>``functional` 组件选项被抛弃](/guide/migration/functional-components.html)
83-
- [异步组件现在需要 `defineAsyncComponent` 方法来创建](/guide/migration/async-components.html)
81+
- [只能使用普通函数创建函数式组件](/guide/migration/functional-components.html)
82+
- [`functional` attribute 在单文件组件 (SFC) `<template>``functional` 组件选项中被废弃](/guide/migration/functional-components.html)
83+
- [异步组件现在需要使用 `defineAsyncComponent` 方法来创建](/guide/migration/async-components.html)
8484
- [组件事件现在需要在 `emits` 选项中声明](./emits-option.md)
8585

8686
### 渲染函数
8787

88-
- [渲染函数 API 改变](/guide/migration/render-function-api.html)
89-
- [`$scopedSlots` property 已删除,所有插槽都通过 `$slots` 作为函数暴露](/guide/migration/slots-unification.html)
88+
- [渲染函数 API 更改](/guide/migration/render-function-api.html)
89+
- [`$scopedSlots` property 已移除,所有插槽都通过 `$slots` 作为函数暴露](/guide/migration/slots-unification.html)
9090
- [`$listeners` 被移除或整合到 `$attrs`](./listeners-removed)
91-
- [`$attrs` 现在包含 `class` and `style` attribute](./attrs-includes-class-style.md)
91+
- [`$attrs` 现在包含 `class` `style` attribute](./attrs-includes-class-style.md)
9292

9393
### 自定义元素
9494

95-
- [自定义元素检测现在已经在编译时执行](/guide/migration/custom-elements-interop.html)
96-
- [对特殊的 `is` prop 的使用只严格限制在被保留的 `<component>` 标记中](/guide/migration/custom-elements-interop.html#定制内置元素)
95+
- [自定义元素检测现在在模板编译时执行](/guide/migration/custom-elements-interop.html)
96+
- [特殊的 `is` prop 的使用被严格限制在被保留的 `<component>` 标签中](/guide/migration/custom-elements-interop.html#定制内置元素)
9797

9898
### 其他小改变
9999

100100
- `destroyed` 生命周期选项被重命名为 `unmounted`
101101
- `beforeDestroy` 生命周期选项被重命名为 `beforeUnmount`
102102
- [`default` prop 工厂函数不再可以访问 `this` 上下文](/guide/migration/props-default-this.html)
103-
- [自定义指令 API 已更改为与组件生命周期一致且 `binding.expression` 已移除](/guide/migration/custom-directives.html)
103+
- [自定义指令的 API 已更改为与组件生命周期一致,且 `binding.expression` 已移除](/guide/migration/custom-directives.html)
104104
- [`data` 选项应始终被声明为一个函数](/guide/migration/data-option.html)
105105
- [来自 mixin 的 `data` 选项现在为浅合并](/guide/migration/data-option.html#mixin-合并行为变更)
106106
- [Attribute 强制策略已更改](/guide/migration/attribute-coercion.html)
107-
- [一些过渡 class 被重命名](/guide/migration/transition.html)
107+
- [一些过渡的 class 被重命名](/guide/migration/transition.html)
108108
- [`<TransitionGroup>` 不再默认渲染包裹元素](/guide/migration/transition-group.html)
109-
- [当侦听一个数组时,只有当数组被替换时,回调才会触发,如果需要在变更时触发,则需要指定 `deep` 选项](/guide/migration/watch.html)
110-
- 没有特殊指令的标记 (`v-if/else-if/else``v-for``v-slot`) 的 `<template>` 现在被视为普通元素,并将生成原生的 `<template>` 元素,而不是渲染其内部内容。
109+
- [当侦听一个数组时,只有当数组被替换时,回调才会触发,如果需要在变更时触发,则必须指定 `deep` 选项](/guide/migration/watch.html)
110+
- 没有特殊指令的标记 (`v-if/else-if/else``v-for``v-slot`) 的 `<template>` 现在被视为普通元素,并将渲染为原生的 `<template>` 元素,而不是渲染其内部内容。
111111
- [已挂载的应用不会取代它所挂载的元素](/guide/migration/mount-changes.html)
112-
- [生命周期 `hook:` 事件前缀改为 `vnode-`](/guide/migration/vnode-lifecycle-events.html)
112+
- [生命周期的 `hook:` 事件前缀改为 `vnode-`](/guide/migration/vnode-lifecycle-events.html)
113113

114-
### 移除 API
114+
### 被移除的 API
115115

116-
- [`keyCode` 支持作为 `v-on` 的修饰符](/guide/migration/keycode-modifiers.html)
116+
- [`keyCode` 作为 `v-on` 修饰符的支持](/guide/migration/keycode-modifiers.html)
117117
- [$on、$off 和 $once 实例方法](/guide/migration/events-api.html)
118-
- [过滤](/guide/migration/filters.html)
118+
- [过滤器 (filter)](/guide/migration/filters.html)
119119
- [内联模板 attribute](/guide/migration/inline-template-attribute.html)
120120
- [`$children` 实例 property](/guide/migration/children.html)
121121
- [`propsData` 选项](/guide/migration/props-data.html)
122122
- `$destroy` 实例方法。用户不应再手动管理单个 Vue 组件的生命周期。
123-
- 全局函数 `set``delete` 以及实例方法 `$set``$delete`基于代理的变化检测不再需要它们了
123+
- 全局函数 `set``delete` 以及实例方法 `$set``$delete`基于代理的变化检测已经不再需要它们了
124124

125-
## 官方支持的库
125+
## 官方的支持库
126126

127-
我们所有的官方库和工具现在都支持 Vue 3,但其中一些仍处于测试版或候选发布状态。你可以在下面找到各个库的详细信息。大多数库目前使用 npm 上的 `next` dist 标签发布。我们打算在所有官方库有了兼容的稳定版本后,就改用 `latest` 标签。
127+
我们所有的官方库和工具现在都支持 Vue 3,但其中一些仍处于测试版或候选发布状态。你可以在下面找到各个库的详细信息。大多数库目前使用 npm 上的 `next` dist 标签发布。我们打算在所有官方库有了稳定的兼容版本后,就改用 `latest` 标签。
128128

129129
### Vue CLI
130130

@@ -139,7 +139,7 @@ Vue 3 中需要关注的一些新功能包括:
139139

140140
<a href="https://www.npmjs.com/package/vue-router/v/next" target="_blank" noopener noreferrer><img src="https://img.shields.io/npm/v/vue-router/next.svg"></a>
141141

142-
Vue Router 4.0 提供了 Vue 3 支持,并有许多突破性的变化,查看[迁移指南](https://next.router.vuejs.org/guide/migration/)获取完整的细节
142+
Vue Router 4.0 提供了 Vue 3 支持,并有许多非兼容的变更,详情见[迁移指南](https://next.router.vuejs.org/guide/migration/)
143143

144144
- [文档](https://next.router.vuejs.org/)
145145
- [Github](https://github.com/vuejs/vue-router-next)
@@ -149,14 +149,14 @@ Vue Router 4.0 提供了 Vue 3 支持,并有许多突破性的变化,查看[
149149

150150
<a href="https://www.npmjs.com/package/vuex/v/next" target="_blank" noopener noreferrer><img src="https://img.shields.io/npm/v/vuex/next.svg"></a>
151151

152-
Vuex 4.0 提供了 Vue 3 支持,其 API 与 3.x 基本相同。唯一的突破性变化是[插件的安装方式](https://next.vuex.vuejs.org/guide/migrating-to-4-0-from-3-x.html#breaking-changes)
152+
Vuex 4.0 提供了 Vue 3 支持,其 API 与 3.x 基本相同。唯一的非兼容变更是[插件的安装方式](https://next.vuex.vuejs.org/guide/migrating-to-4-0-from-3-x.html#breaking-changes)
153153

154154
- [文档](https://next.vuex.vuejs.org/)
155155
- [Github](https://github.com/vuejs/vuex/tree/4.0)
156156

157-
### Devtools Extension
157+
### Devtools 扩展
158158

159-
我们正在开发一个新版本的 Devtools,它有一个新的 UI 和经过重构的内部结构,以支持多个 Vue 版本。新版本目前处于测试阶段,目前只支持 Vue 3。Vuex 和路由器的集成也在进行中
159+
我们正在开发一个新版本的 Devtools,它有一个新的 UI 和经过重构的内部结构,以支持多个 Vue 版本。新版本目前处于测试阶段,目前只支持 Vue 3。Vuex 和 Router 的集成也在进行中
160160

161161
- Chrome:[从 Chrome web 商店中安装](https://chrome.google.com/webstore/detail/vuejs-devtools/ljjemllljcmogpfapbkkighbhhppjdbg?hl=en)
162162

src/guide/migration/migration-build.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -318,9 +318,9 @@ export default {
318318
| COMPONENT_ASYNC || 异步组件 API 改变 (现在需要 `defineAsyncComponent`) | [链接](/guide/migration/async-components.html) |
319319
| COMPONENT_FUNCTIONAL || 函数式组件 API 改变 (现在必须只是一个普通函数) | [链接](/guide/migration/functional-components.html) |
320320
| COMPONENT_V_MODEL || 组件的 v-model 修改 | [链接](/guide/migration/v-model.html) |
321-
| RENDER_FUNCTION || 渲染函数 API 改变 | [链接](/guide/migration/render-function-api.html) |
321+
| RENDER_FUNCTION || 渲染函数 API 更改 | [链接](/guide/migration/render-function-api.html) |
322322
| FILTERS || 过滤器被移除 (该选项只会影响运行时的过滤器 API) | [链接](/guide/migration/filters.html) |
323-
| COMPILER_IS_ON_ELEMENT || `is` 现在只能严格用在 `<component>`| [链接](/guide/migration/custom-elements-interop.html) |
323+
| COMPILER_IS_ON_ELEMENT || `is` 的使用现在被严格限制在 `<component>`| [链接](/guide/migration/custom-elements-interop.html) |
324324
| COMPILER_V_BIND_SYNC || `v-bind.sync` 被替换为带参数的 `v-model` | [链接](/guide/migration/v-model.html) |
325325
| COMPILER_V_BIND_PROP || `v-bind.prop` 修饰符被移除 | |
326326
| COMPILER_V_BIND_OBJECT_ORDER || `v-bind="object"` 现在是顺序敏感的 | [链接](/guide/migration/v-bind.html) |

src/guide/migration/transition-as-root.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,5 +57,5 @@ export default {
5757

5858
## 参考
5959

60-
- [有些过渡的 class 名更改](/guide/migration/transition.html)
60+
- [一些过渡的 class 被重命名](/guide/migration/transition.html)
6161
- [`<TransitionGroup>` 不再默认渲染根元素](/guide/migration/transition-group.html)

0 commit comments

Comments
 (0)