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

Commit 64f2778

Browse files
authored
Merge pull request #155 from watonyweng/master
docs: global-api.md
2 parents fcdfed3 + b6dbb8d commit 64f2778

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

src/guide/migration/global-api.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -16,18 +16,18 @@ Vue.component('button-counter', {
1616
})
1717
```
1818

19-
类似地,以下是全局指令的声明方式
19+
类似地,使用全局指令的声明方式如下
2020

2121
```js
2222
Vue.directive('focus', {
2323
inserted: el => el.focus()
2424
})
2525
```
2626

27-
虽然这种方法很方便,但它会导致一些问题。从技术上讲,Vue 2 没有“app”的概念,我们定义的应用程序只是通过 `new Vue()` 创建的根 Vue 实例。从同一个 Vue 构造函数**创建的每个根实例共享相同的全局配置**,因此:
27+
虽然这种声明方式很方便,但它也会导致一些问题。从技术上讲,Vue 2 没有“app”的概念,我们定义的应用只是通过 `new Vue()` 创建的根 Vue 实例。从同一个 Vue 构造函数**创建的每个根实例共享相同的全局配置**,因此:
2828

2929

30-
- 全局配置使得在测试期间很容易意外地污染其他测试用例。用户需要仔细存储原始全局配置,并在每次测试后恢复 (例如重置 `Vue.config.errorHandler`)。有些 API 像 `Vue.use` 以及 `Vue.mixin` 甚至连恢复效果的方法都没有,这使得涉及插件的测试特别棘手。实际上,vue test utils 必须实现一个特殊的 API `createLocalVue` 来处理此问题:
30+
- 在测试期间,全局配置很容易意外地污染其他测试用例。用户需要仔细存储原始全局配置,并在每次测试后恢复 (例如重置 `Vue.config.errorHandler`)。有些 API 像 `Vue.use` 以及 `Vue.mixin` 甚至连恢复效果的方法都没有,这使得涉及插件的测试特别棘手。实际上,vue-test-utils 必须实现一个特殊的 API `createLocalVue` 来处理此问题:
3131

3232
```js
3333
import { createLocalVue, mount } from '@vue/test-utils'
@@ -64,7 +64,7 @@ import { createApp } from 'vue'
6464
const app = createApp({})
6565
```
6666

67-
应用程序实例暴露当前全局 API 的子集,经验法则是,任何全局改变 Vue 行为的 API 现在都会移动到应用实例上,以下是当前全局 API 及其相应实例 API 的表:
67+
应用实例暴露当前全局 API 的子集,经验法则是,任何全局改变 Vue 行为的 API 现在都会移动到应用实例上,以下是当前全局 API 及其相应实例 API 的表:
6868

6969
| 2.x 全局 API | 3.x 实例 API (`app`) |
7070
| -------------------------- | ------------------------------------------------------------------------------------------- |
@@ -105,9 +105,9 @@ app.config.isCustomElement = tag => tag.startsWith('ion-')
105105
- 这将是 Vue CLI 配置中新的顶层选项。
106106
:::
107107

108-
### 插件作者须知
108+
### 插件使用者须知
109109

110-
插件作者通常使用 `Vue.use`。例如,官方的 `vue-router` 插件是如何在浏览器环境中自行安装的:
110+
插件开发者通常使用 `Vue.use`。例如,官方的 `vue-router` 插件是如何在浏览器环境中自行安装的:
111111

112112
```js
113113
var inBrowser = typeof window !== 'undefined'
@@ -117,7 +117,7 @@ if (inBrowser && window.Vue) {
117117
}
118118
```
119119

120-
由于 `use` 全局 API 在 Vue 3 中不再可用,此方法将停止工作并停止调用 `Vue.use()` 现在将触发警告,于是,最终用户现在必须在应用程序实例上显式指定使用插件
120+
由于 `use` 全局 API 在 Vue 3 中不再使用,此方法将停止工作并停止调用 `Vue.use()` 现在将触发警告,于是,开发者必须在应用程序实例上显式指定使用此插件
121121

122122
```js
123123
const app = createApp(MyApp)
@@ -158,7 +158,7 @@ app.mount('#app')
158158

159159
## 提供/注入 (Provide / Inject)
160160

161-
与在 2.x 根实例中使用 `provide` 选项类似,Vue 3 应用程序实例还可以提供可由应用程序内的任何组件注入的依赖项
161+
与在 2.x 根实例中使用 `provide` 选项类似,Vue 3 应用实例还可以提供可由应用内的任何组件注入的依赖项
162162

163163
```js
164164
// 在入口
@@ -175,9 +175,9 @@ export default {
175175
}
176176
```
177177

178-
## 在应用程序之间共享配置
178+
## 在应用之间共享配置
179179

180-
在应用程序之间共享配置 (如组件或指令) 的一种方法是创建工厂功能,如下所示:
180+
在应用之间共享配置 (如组件或指令) 的一种方法是创建工厂功能,如下所示:
181181

182182
```js
183183
import { createApp } from 'vue'

0 commit comments

Comments
 (0)