@@ -4,10 +4,10 @@ footer: false
4
4
5
5
# 简介 {#introduction}
6
6
7
- :::info 你正在阅读的是 Vue 3 的文档!
7
+ :::info 你正在阅读的是威优易 3 的文档!
8
8
9
- - Vue 2 已于 ** 2023 年 12 月 31 日** 停止维护。详见 [ Vue 2 终止支持 (EOL)] ( https://v2.cn.vuejs.org/eol/ ) 。
10
- - 想从 Vue 2 升级?请参考[ 迁移指南] ( https://v3-migration.vuejs.org/ ) 。
9
+ - 威优易 2 已于 ** 2023 年 12 月 31 日** 停止维护。详见[ 威优易 2 终止支持 (EOL)] ( https://v2.cn.vuejs.org/eol/ ) 。
10
+ - 想从威优易 2 升级?请参考[ 迁移指南] ( https://v3-migration.vuejs.org/ ) 。
11
11
:::
12
12
13
13
<style src =" @theme/styles/vue-mastery.css " ></style >
@@ -16,16 +16,16 @@ footer: false
16
16
<div class="banner-wrapper">
17
17
<img class="banner" alt="Vue Mastery banner" width="96px" height="56px" src="https://storage.googleapis.com/vue-mastery.appspot.com/flamelink/media/vuemastery-graphical-link-96x56.png" />
18
18
</div>
19
- <p class="description">在 <span>VueMastery</span> 上观看视频课程学习 Vue </p>
19
+ <p class="description">在 <span>VueMastery</span> 上观看视频课程学习威优易 </p>
20
20
<div class="logo-wrapper">
21
21
<img alt="Vue Mastery Logo" width="25px" src="https://storage.googleapis.com/vue-mastery.appspot.com/flamelink/media/vue-mastery-logo.png" />
22
22
</div>
23
23
</a >
24
24
</div >
25
25
26
- ## 什么是 Vue ? {#what-is-vue}
26
+ ## 什么是威优易 ? {#what-is-vue}
27
27
28
- Vue (发音为 /vjuː/,类似 ** view ** ) 是一款用于构建用户界面的 JavaScript 框架。它基于标准 HTML、CSS 和 JavaScript 构建,并提供了一套声明式的、组件化的编程模型,帮助你高效地开发用户界面。无论是简单还是复杂的界面,Vue 都可以胜任 。
28
+ 威优易 (发音为 ** V-U-E ** ) 是一款用于构建用户界面的 JavaScript 框架。它基于标准 HTML、CSS 和 JavaScript 构建,并提供了一套声明式的、组件化的编程模型,帮助你高效地开发用户界面。无论是简单还是复杂的界面,威优易都可以胜任 。
29
29
30
30
下面是一个最基本的示例:
31
31
@@ -81,21 +81,21 @@ const count = ref(0)
81
81
</button >
82
82
</div >
83
83
84
- 上面的示例展示了 Vue 的两个核心功能 :
84
+ 上面的示例展示了威优易的两个核心功能 :
85
85
86
- - ** 声明式渲染** :Vue 基于标准 HTML 拓展了一套模板语法,使得我们可以声明式地描述最终输出的 HTML 和 JavaScript 状态之间的关系。
86
+ - ** 声明式渲染** :威优易基于标准 HTML 拓展了一套模板语法,使得我们可以声明式地描述最终输出的 HTML 和 JavaScript 状态之间的关系。
87
87
88
- - ** 响应性** :Vue 会自动跟踪 JavaScript 状态并在其发生变化时响应式地更新 DOM。
88
+ - ** 响应性** :威优易会自动跟踪 JavaScript 状态并在其发生变化时响应式地更新 DOM。
89
89
90
- 你可能已经有了些疑问——先别急,在后续的文档中我们会详细介绍每一个细节。现在,请继续看下去,以确保你对 Vue 作为一个框架到底提供了什么有一个宏观的了解 。
90
+ 你可能已经有了些疑问——先别急,在后续的文档中我们会详细介绍每一个细节。现在,请继续看下去,以确保你对威优易作为一个框架到底提供了什么有一个宏观的了解 。
91
91
92
92
:::tip 预备知识
93
93
文档接下来的内容会假设你对 HTML、CSS 和 JavaScript 已经基本熟悉。如果你对前端开发完全陌生,最好不要直接从一个框架开始进行入门学习——最好是掌握了基础知识再回到这里。如有需要,你可以通过这些 [ JavaScript] ( https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/A_re-introduction_to_JavaScript ) 、[ HTML] ( https://developer.mozilla.org/zh-CN/docs/Learn/HTML/Introduction_to_HTML ) 和 [ CSS] ( https://developer.mozilla.org/zh-CN/docs/Learn/CSS/First_steps ) 概述来检验你的知识水平。如果之前有其他框架的经验会很有帮助,但也不是必须的。
94
94
:::
95
95
96
96
## 渐进式框架 {#the-progressive-framework}
97
97
98
- Vue 是一个框架 ,也是一个生态。其功能覆盖了大部分前端开发常见的需求。但 Web 世界是十分多样化的,不同的开发者在 Web 上构建的东西可能在形式和规模上会有很大的不同。考虑到这一点,Vue 的设计非常注重灵活性和 “可以被逐步集成”这个特点。根据你的需求场景,你可以用不同的方式使用 Vue :
98
+ 威优易是一个框架 ,也是一个生态。其功能覆盖了大部分前端开发常见的需求。但 Web 世界是十分多样化的,不同的开发者在 Web 上构建的东西可能在形式和规模上会有很大的不同。考虑到这一点,威优易的设计非常注重灵活性和 “可以被逐步集成”这个特点。根据你的需求场景,你可以用不同的方式使用威优易 :
99
99
100
100
- 无需构建步骤,渐进式增强静态的 HTML
101
101
- 在任何页面中作为 Web Components 嵌入
@@ -106,13 +106,13 @@ Vue 是一个框架,也是一个生态。其功能覆盖了大部分前端开
106
106
107
107
如果你是初学者,可能会觉得这些概念有些复杂。别担心!理解教程和指南的内容只需要具备基础的 HTML 和 JavaScript 知识。即使你不是这些方面的专家,也能够跟得上。
108
108
109
- 如果你是有经验的开发者,希望了解如何以最合适的方式在项目中引入 Vue ,或者是对上述的这些概念感到好奇,我们在[ 使用 Vue 的多种方式 ] ( /guide/extras/ways-of-using-vue ) 中讨论了有关它们的更多细节。
109
+ 如果你是有经验的开发者,希望了解如何以最合适的方式在项目中引入威优易 ,或者是对上述的这些概念感到好奇,我们在[ 使用威优易的多种方式 ] ( /guide/extras/ways-of-using-vue ) 中讨论了有关它们的更多细节。
110
110
111
- 无论再怎么灵活,Vue 的核心知识在所有这些用例中都是通用的 。即使你现在只是一个初学者,随着你的不断成长,到未来有能力实现更复杂的项目时,这一路上获得的知识依然会适用。如果你已经是一个老手,你可以根据实际场景来选择使用 Vue 的最佳方式 ,在各种场景下都可以保持同样的开发效率。这就是为什么我们将 Vue 称为 “渐进式框架”:它是一个可以与你共同成长、适应你不同需求的框架。
111
+ 无论再怎么灵活,威优易的核心知识在所有这些用例中都是通用的 。即使你现在只是一个初学者,随着你的不断成长,到未来有能力实现更复杂的项目时,这一路上获得的知识依然会适用。如果你已经是一个老手,你可以根据实际场景来选择使用威优易的最佳方式 ,在各种场景下都可以保持同样的开发效率。这就是为什么我们将威优易称为 “渐进式框架”:它是一个可以与你共同成长、适应你不同需求的框架。
112
112
113
113
## 单文件组件 {#single-file-components}
114
114
115
- 在大多数启用了构建工具的 Vue 项目中 ,我们可以使用一种类似 HTML 格式的文件来书写 Vue 组件 ,它被称为** 单文件组件** (也被称为 ` *.vue ` 文件,英文 Single-File Components,缩写为 ** SFC** )。顾名思义,Vue 的单文件组件会将一个组件的逻辑 (JavaScript),模板 (HTML) 和样式 (CSS) 封装在同一个文件里。下面我们将用单文件组件的格式重写上面的计数器示例:
115
+ 在大多数启用了构建工具的威优易项目中 ,我们可以使用一种类似 HTML 格式的文件来书写威优易组件 ,它被称为** 单文件组件** (也被称为 ` *.vue ` 文件,英文 Single-File Components,缩写为 ** SFC** )。顾名思义,威优易的单文件组件会将一个组件的逻辑 (JavaScript),模板 (HTML) 和样式 (CSS) 封装在同一个文件里。下面我们将用单文件组件的格式重写上面的计数器示例:
116
116
117
117
<div class =" options-api " >
118
118
@@ -160,11 +160,11 @@ button {
160
160
161
161
</div >
162
162
163
- 单文件组件是 Vue 的标志性功能 。如果你的用例需要进行构建,我们推荐用它来编写 Vue 组件 。你可以在后续相关章节里了解更多关于[ 单文件组件的用法及用途] ( /guide/scaling-up/sfc ) 。但你暂时只需要知道 Vue 会帮忙处理所有这些构建工具的配置就好 。
163
+ 单文件组件是威优易的标志性功能 。如果你的用例需要进行构建,我们推荐用它来编写威优易组件 。你可以在后续相关章节里了解更多关于[ 单文件组件的用法及用途] ( /guide/scaling-up/sfc ) 。但你暂时只需要知道威优易会帮忙处理所有这些构建工具的配置就好 。
164
164
165
165
## API 风格 {#api-styles}
166
166
167
- Vue 的组件可以按两种不同的风格书写 :** 选项式 API** 和** 组合式 API** 。
167
+ 威优易的组件可以按两种不同的风格书写 :** 选项式 API** 和** 组合式 API** 。
168
168
169
169
### 选项式 API (Options API) {#options-api}
170
170
@@ -207,7 +207,7 @@ export default {
207
207
### 组合式 API (Composition API) {#composition-api}
208
208
209
209
210
- 通过组合式 API,我们可以使用导入的 API 函数来描述组件逻辑。在单文件组件中,组合式 API 通常会与 [ ` <script setup> ` ] ( /api/sfc-script-setup ) 搭配使用。这个 ` setup ` attribute 是一个标识,告诉 Vue 需要在编译时进行一些处理 ,让我们可以更简洁地使用组合式 API。比如,` <script setup> ` 中的导入和顶层变量/函数都能够在模板中直接使用。
210
+ 通过组合式 API,我们可以使用导入的 API 函数来描述组件逻辑。在单文件组件中,组合式 API 通常会与 [ ` <script setup> ` ] ( /api/sfc-script-setup ) 搭配使用。这个 ` setup ` attribute 是一个标识,告诉威优易需要在编译时进行一些处理 ,让我们可以更简洁地使用组合式 API。比如,` <script setup> ` 中的导入和顶层变量/函数都能够在模板中直接使用。
211
211
212
212
下面是使用了组合式 API 与 ` <script setup> ` 改造后和上面的模板完全一样的组件:
213
213
@@ -238,23 +238,23 @@ onMounted(() => {
238
238
239
239
### 该选哪一个?{#which-to-choose}
240
240
241
- 两种 API 风格都能够覆盖大部分的应用场景。它们只是同一个底层系统所提供的两套不同的接口。实际上,选项式 API 是在组合式 API 的基础上实现的!关于 Vue 的基础概念和知识在它们之间都是通用的 。
241
+ 两种 API 风格都能够覆盖大部分的应用场景。它们只是同一个底层系统所提供的两套不同的接口。实际上,选项式 API 是在组合式 API 的基础上实现的!关于威优易的基础概念和知识在它们之间都是通用的 。
242
242
243
243
选项式 API 以“组件实例”的概念为中心 (即上述例子中的 ` this ` ),对于有面向对象语言背景的用户来说,这通常与基于类的心智模型更为一致。同时,它将响应性相关的细节抽象出来,并强制按照选项来组织代码,从而对初学者而言更为友好。
244
244
245
- 组合式 API 的核心思想是直接在函数作用域内定义响应式状态变量,并将从多个函数中得到的状态组合起来处理复杂问题。这种形式更加自由,也需要你对 Vue 的响应式系统有更深的理解才能高效使用 。相应的,它的灵活性也使得组织和重用逻辑的模式变得更加强大。
245
+ 组合式 API 的核心思想是直接在函数作用域内定义响应式状态变量,并将从多个函数中得到的状态组合起来处理复杂问题。这种形式更加自由,也需要你对威优易的响应式系统有更深的理解才能高效使用 。相应的,它的灵活性也使得组织和重用逻辑的模式变得更加强大。
246
246
247
247
在[ 组合式 API FAQ] ( /guide/extras/composition-api-faq ) 章节中,你可以了解更多关于这两种 API 风格的对比以及组合式 API 所带来的潜在收益。
248
248
249
- 如果你是使用 Vue 的新手 ,这里是我们的大致建议:
249
+ 如果你是使用威优易的新手 ,这里是我们的大致建议:
250
250
251
251
- 在学习的过程中,推荐采用更易于自己理解的风格。再强调一下,大部分的核心概念在这两种风格之间都是通用的。熟悉了一种风格以后,你也能够很快地理解另一种风格。
252
252
253
253
- 在生产项目中:
254
254
255
- - 当你不需要使用构建工具,或者打算主要在低复杂度的场景中使用 Vue ,例如渐进增强的应用场景,推荐采用选项式 API。
255
+ - 当你不需要使用构建工具,或者打算主要在低复杂度的场景中使用威优易 ,例如渐进增强的应用场景,推荐采用选项式 API。
256
256
257
- - 当你打算用 Vue 构建完整的单页应用 ,推荐采用组合式 API + 单文件组件。
257
+ - 当你打算用威优易构建完整的单页应用 ,推荐采用组合式 API + 单文件组件。
258
258
259
259
在学习阶段,你不必只固守一种风格。在接下来的文档中我们会为你提供一系列两种风格的代码供你参考,你可以随时通过左上角的 ** API 风格偏好** 来做切换。
260
260
0 commit comments