5. 第 4 章 - [Vue.js] 简介
5.1. 来源
本章基于 [Vue.js] 的官方文档:vuejs.org,尤其是其指南(vuejs.org/guide/introduction.html)。
5.2. 从 AngularJS 1.x 到 [Vue.js]
原始文档(2014 年)使用的是 AngularJS 1.x:这是一个(当时还不是 TypeScript 的)框架,围绕 $scope、控制器、指令(ng-repeat、ng-if……)组织,其变更检测机制基于“摘要循环”($digest)和变量监视($watch)。
[Vue.js] (由 Evan You 于 2014 年创建,源于他在 Google 研究 AngularJS 的经历)与 [Angular] 一样,是一个功能完备的框架:不同于 [React] (一个简单的界面库),它提供自己的组件系统、响应式状态管理,以及——通过本文档不使用的、单独的官方包——路由器([vue-router])和全局状态管理器([Pinia])。[Vue.js] 自称是“渐进式”的:核心专注于视图层(概念上类似于 AngularJS 1.x 的 $scope/模板),再辅以自己的组件格式——[.vue] 文件(见下文)。本章逐一介绍这些概念,并配以独立于案例研究的简短示例——下一章将探讨它们在完整的 [RdvMedecins] 客户端中的应用,使用的是 [Vue.js] 3。
5.3. [Vue.js] 应用程序背后的概念:“单页应用”
[Vue.js] 应用程序与 [Angular] 或 [React] 应用程序一样,是单页应用(SPA):服务器只向浏览器发送一个 HTML 页面,其中包含一个内嵌了应用全部逻辑的 JavaScript 文件。该页面加载完成后,再也不会有完整的页面重新加载:每一次用户交互(切换视图、提交表单等)都由浏览器中已有的 JavaScript 代码处理,它更新显示,并通过异步 HTTP 请求(多数使用 JSON)在后台与服务器通信。这也是使用 AngularJS 1.x 的原始文档的原理,以及本课程中 [Angular] 和 [React] 变体的原理——它没有改变:不同变体之间只是负责显示的框架有所不同。
5.4. 组件:[.vue] 文件和 [Composition API]
与 [Angular] 和 [React] 一样,组件是 [Vue.js] 应用程序的基本单元:它根据自己的当前状态和接收到的属性生成要在屏幕上显示的内容。区别在于形式:[Angular] 组件是一个带装饰器的类,关联一个单独的(或内联的)HTML 模板;[React] 组件是一个返回 [JSX] 的函数;[Vue.js] 组件是一个“单文件”[.vue] 文件,它把三个不同的块合并到同一个文件中:一个 [<template>] (HTML,类似于 [Angular] 的模板)、一个 [<script setup>] (逻辑,如同 TypeScript 中那样),以及可选的 [<style>] (该组件特有的样式)。
下面是一个非常小的组件,独立于案例研究,相当于本课程中已经介绍过的 [CounterComponent] ([Angular])和 [Counter.tsx] ([React]):
我们来解读这段代码:
- 第 3 行:[import { ref } from 'vue';] ——[ref] 是 [Vue.js] 中创建响应式值的函数,其作用可与 [Angular] 一侧的 signal,或 [useState] 在 [React] 一侧的作用相比;
- 第 5 行:[const value = ref(0);] ——[ref(0)] 创建一个初始化为 0 的响应式“盒子”。与返回一对值(值和一个 setter)的 [useState]()([React])不同,[ref()] 返回的是单个对象,其值通过 [.value] 属性读取和写入——这种机制在概念上更类似于 [signal()] [Angular](通过 [mySignal()] 读取,通过 [mySignal.set(...)] 写入),而不是 [value, setValue] 这样的值对;
- 第 8 行:[value.value++;] ——修改 [.value] 会更新该值,并自动重绘 [<template>] 中所有依赖它的内容——这与 [mySignal.update(v => v + 1)] 在 [Angular] 中的情形完全一样;与 [React] (其状态值是不可变的)不同,这里没有任何东西阻止直接递增(++)[.value],而无需经过单独的更新函数;
- 第 12–13 行:[Value: {{ value }}] ——[<template>] 就是模板,就像 HTML 与 [Angular] 是分离的那样——不同于 [JSX] 和 [React],它们源自 JavaScript,并与组件函数的代码混在一起。双花括号 [{{ }}] 在此插入一个表达式——作用与 [{{ value() }}] 在 [Angular] 中相同([Vue.js] 不需要调用括号(是 [value],而不是 [value()]):在 [<template>] 中,[ref] 会被自动“解包”;永远不需要写 [.value])。
5.5. 本地状态:[ref]/[reactive] 与 props
在 AngularJS 1.x 中,[Angular] 通过系统性的检查循环($digest)来检测数据是否已更改,在本课程的 [Angular] 变体中,它被信号(signal()、computed())取代。[React] 采取不同的方式:每次状态变化时,组件都会完整地重新执行其函数。[Vue.js] 采取第三种混合方式:与 [Angular] 一样,它精确地跟踪组件使用的响应式值(得益于编译后的 [<template>] 和 [ref]/[reactive] 的“代理”系统),并且只更新 DOM 中真正依赖这些值的部分——从不重新执行整个 [<script setup>],也无需 [React] 为达到类似效果所使用的虚拟 DOM 的开销。
函数 | 作用 |
创建只有单个值的本地状态;在 [.value] 中,通过 [<script>] 读取/写入(绝不在 [<template>]中) | |
创建具有多个属性(一个对象)的本地状态;直接读取/写入,不使用 [.value],逐个属性进行 | |
从其他 [ref]/[reactive] 派生出一个值,只有当其依赖项变化时才会自动重新计算——直接相当于 [computed()] 在 [Angular] 一侧,以及 [useMemo]() 在 [React] 一侧 | |
重新执行 [callback] ,每当 [source] 变化时——相当于 [useEffect](..., [dep]) 在 [React] 一侧,或 [effect()] 在 [Angular] 一侧 |
有两种机制补充 [ref]/[reactive] ,使组件能够与其父组件通信——它们在 [RdvMedecins] 客户端(下一章)中始终出现在原先 [input()]/[output()] 在 [Angular] 一侧所在的位置,以及 props/回调 props 在 [React] 一侧所在的位置:
- props([defineProps<...>()]):[Vue.js] 组件使用 [defineProps] 声明其输入的格式,这是一个被编译器识别的特殊函数(不需要任何 [import])——直接相当于 [input.required<Doctor[]>()] 在 [Angular] 一侧的写法,以及解构后的 props 对象在 [React] 一侧的写法;
- 事件([defineEmits<...>()]):不同于作为 prop 传入的简单函数([React] 的选择),[Vue.js] 显式地区分组件所触发的事件——它返回的函数 [emit(‘eventName’, value)] 直接相当于 [search.emit(value)] 在 [Angular] 一侧的写法([output<...>()])。
5.6. 没有模块:每个文件都已自成一体
AngularJS 1.x 应用程序被组织成模块(angular.module(...))。[Angular] 最初以更僵化的形式采纳了这一理念(NgModule 文件),后来才提出把独立组件作为默认模式。与 [React] 一样,[Vue.js] 从不需要这个概念:[.vue] 文件会隐式导出其组件([<script setup>] 就是文件的默认导出,甚至无需指定 [export] 关键字),另一个文件只需用简单的 [import] 就能使用它——这是标准的 ECMAScript 模块,没有任何额外的框架专属层:
本文档的 [RdvMedecins] 客户端(下一章)通篇采用这种风格:没有 *.module.ts 文件,也没有需要维护的 [imports: [...]] 装饰器——这种简化与前面在 [React] 中已看到的相同,相对于 AngularJS 1.x 和带 NgModule 的 [Angular] 而言。
5.7. 共享逻辑:组合式函数与 [provide]/[inject]
与 [NestJS] (第 2 章)一样,[RdvMedecins] 客户端需要在多个组件之间共享逻辑:与服务器通信、识别已登录用户,以及切换语言。[Angular] 通过可注入的服务来满足这一需求([@Injectable]({ providedIn: ‘root’ }) + inject(...));[React] 将自定义 Hook 与 [Context] 结合使用。[Vue.js] 使用的组合与 [React] 类似,但有自己的词汇和机制:
- 组合式函数——其名称按约定以 [use] 开头(类似于 [React] 的 Hook),它本身可以调用其他 [Vue.js] 函数([ref]、[inject]……)——封装可复用的逻辑,就像服务器端的服务方法 [Angular] 那样;
- 一对 [provide]/[inject] 把一个值(状态 + 函数)共享给整个组件子树,而无需逐层手动地、逐个属性地向下传递——它起的作用相当于 [providedIn: ‘root’] 在 [Angular] 一侧,以及 [Context] 在 [React] 一侧。不同于 [React] 需要把 [Provider] 组件在树中围绕根组件直观地嵌套,[Vue.js] 只需在应用实例上进行一次函数调用 [app.provide(key, value)] 即可提供一个值(参见 main.ts,下一章)——无需任何组件嵌套。
下面是一个简短的示例,独立于案例研究,在概念上相当于本课程中已经介绍过的 [MyService] ([Angular])和 [my-context.tsx] ([React]):
我们来解读这段代码:
- 第 8 行:[const MyStoreKey: InjectionKey<MyStore> = Symbol('MyStore');] ——注入键:使用 [Symbol] 而不是简单的字符串,以避免与另一个同名的键意外冲突——[InjectionKey<T>] 在类型层面只是 [Symbol] 的别名,这使 [inject()] 能够自动确定所返回值的类型;
- 第 10 行:[export function createMyStore(): MyStore {] ——工厂函数,只被调用一次(在 [main.ts] 中;参见下一章),而且是在任何组件存在之前——这就是为什么它把任何依赖项作为普通的函数参数接收,而不是通过 [inject()];
- 第 11 行:[return reactive<MyStore>({] ——[reactive(...)] 把对象包装在 JavaScript 代理中:在 [<template>] 中对其任一属性的读取都会自动登记一个依赖;任何写入操作都会重绘所有依赖它的内容——不同于 [ref()],其属性([store.greet])是直接读取和写入的,无需 [.value];
- 第 16–22 行:[export function useMyStore(): MyStore { …] ——组件调用的组合式函数([const my = useMyStore();]),就像它们原本会调用 [inject(MyService)] (来自 [Angular])或 [useMyContext()] (来自 [React])一样;如果 [inject(MyStoreKey)] 返回 [undefined] ,所抛出的错误表明漏了接线(相应的 [app.provide(...)] 没有被调用)——与 [React] 一侧完全相同的安全网(Context 默认为 null)。
5.8. 与服务器通信:[fetch]
[HttpClient] ([Angular])是原始文档所用的 AngularJS 1.x 的 $http 服务的直接继任者。与 [React] 一样,[Vue.js] 只是一个界面框架,其核心不提供任何 HTTP 客户端:[RdvMedecins] 客户端直接使用 [fetch],即浏览器的标准 API(无需任何额外依赖即可使用):
与 $http 和 [HttpClient] 的一个重要区别:[fetch] 直接返回一个 Promise(JavaScript 的标准异步机制),而不是 Observable——没有 RxJS 库,没有 [.subscribe]({ next, error }),也没有 [.pipe(map(...))]。可以配合 [.then(...)] 使用,或者为了更好的可读性,使用 async/await(如上所示)。网络错误或错误响应随后只需用一个简单的 try/catch 块处理,而不是用 RxJS 订阅的错误分支——与 [React] 一侧完全一样。
[useAppointmentService()] 组合式函数(属于 [RdvMedecins] 客户端,见下一章)系统地封装了这个 [fetch] 调用及随后的 [.json()],这有一个特定的原因,将在那里说明(所有服务器响应共用的 [ServerResponse]<T> 包装)。
5.9. 条件渲染与列表:[v-if]/[v-else] 和 [v-for]
AngularJS 1.x 使用结构型指令(ng-if、ng-repeat)来有条件地显示元素,或为列表中的每个元素重复一个模板块。本课程的 [Angular] 变体使用内置语法 [@if]/[@for];[React] 客户端则用纯 JavaScript 的三元运算符和 [.map(...)] 来表达同样的事情。[Vue.js] 在这一点上更接近 [Angular]:它的 [<template>] 有自己的指令“语言”,在精神上与 AngularJS 1.x 非常相似(ng-if 变成 [v-if],ng-repeat 变成 [v-for]):
我们来解读这段代码:
- 第 1–2 行:[v-if="loggedInUser" … v-else …] ——[v-if]/[v-else] 取代了 [@if]/[@else]([Angular])和 ng-if(AngularJS 1.x):只有条件为真的分支才会被挂载到 DOM 中——行为与三元运算符 [React] ({ condition ? ... : ... })完全相同,只不过它是用 HTML 属性来表达,而不是嵌套在 [JSX] 中的 JavaScript 表达式;
- 第 5 行:[v-for="item in itemList" :key="item.id"] ——[v-for] 取代了 [@for] ([Angular])和 ng-repeat(AngularJS 1.x),作用与 [.map(...)] 在 [React] 一侧完全相同:为数组中的每个条目重复该元素。[:key](必需,正如 [key={item.id}] 在 [React] 中,以及 track 在 [Angular] 中)告诉 [Vue.js] 在重绘列表时如何识别已经显示过的元素。
5.10. 小结:对应关系 [Angular] -> [React] -> [Vue.js]
[Angular]/[React] (本课程的早期版本) | [Vue.js] (2026) |
单文件组件([.vue]) | |
[ref]()/[reactive](),[defineProps]/[defineEmits],[computed]() | |
[watch]() | |
[<template>] + [<script setup>] 合并在同一个文件 [.vue] 中 | |
[v-if]/[v-else],[v-for] | |
组合式函数 + [provide]/[inject] | |
[fetch] (原生 Promise,如同 [React]) | |
没有路由器(同样的结论,更进一步) | |
[Vite] (使用 [@vitejs/plugin-vue] 而不是 [@vitejs/plugin-react]) |
掌握这些概念,就足以着手下一章的 [RdvMedecins] 客户端了:不过,每种新的用法都会随着代码的推进,在其出现的确切位置再次加以说明。