Skip to main content

Welcome to a Grasp lesson

Create a free account to keep studying and create your own study path.

Lesson 1

Vue 3 响应式组件:组合式 API 实战 (setup, ref, reactive)

Recommended resources

你好!欢迎开始你的全栈开发学习之旅。这个课程是为你量身打造的,旨在帮助你从已有的前端经验平稳过渡,并从零开始掌握 Node.js 后端开发,最终实现成为一名全栈开发者的目标。

我们的第一站是快速回顾 Vue.js 的核心技术。虽然你已经有 Vue 的使用经验,但我们将专注于 Vue 3 最新的组合式 API(Composition API),这可能是你之前较少接触的,但它却是现代 Vue 开发的主流范式。

课程简介

在本节课中,你将学习如何使用 Vue 3 组合式 API(setup、ref 和 reactive)来创建响应式组件。

我们将一起探讨:

  • Vue 的响应式系统为何如此重要。
  • 如何使用 ref 来处理单个值(如数字、字符串)。
  • 如何使用 reactive 来处理更复杂的数据结构(如对象)。
  • ref 和 reactive 的核心区别和各自的最佳使用场景。

掌握这些是构建任何动态前端应用的基础,也是我们后续开发复杂功能(如用户认证、数据展示)的基石。



1. Vue 的响应式核心

作为一名开发者,你肯定知道,在传统的 JavaScript 中,如果我们改变了一个变量的值,页面上显示该变量的地方并不会自动更新。你需要手动操作 DOM 来反映这个变化。

Vue 的核心特性之一就是响应式系统。它允许我们以声明式的方式将数据和 DOM 关联起来。当你修改数据时,Vue 会自动侦测到变化并高效地更新视图。

在 Vue 3 的组合式 API 中,实现响应式主要依赖两个函数:ref() 和 reactive()。让我们先从一个宏观的视角看看它们。

这张图片直观地展示了 Vue 3 组合式 API 中的几个核心概念。今天,我们的焦点是左侧的 `ref` 和 `reactive`。

那么,为什么我们不能直接用普通的 JavaScript 变量,而必须用 ref 或 reactive 包装一下呢?这背后是 Vue 的依赖追踪机制。

为了更深入地理解其工作原理,请阅读 Vue 官方文档中的解释。这会帮助你从根本上理解为什么代码要这么写。

响应式基础 - Vue.js

请阅读 Vue 官方文档《响应式基础》中关于为什么需要 ref 的部分。这部分内容会为你解释 Vue 是如何通过 .value 属性来追踪依赖并触发更新的。

请重点阅读 “<span data-type="resource_reading_textrange" data-resource-subitem-id="e1e29a2f" data-range-start="在组合式 API 中,推荐使用" data-range-end="选项中使用组合式 API。">ref()</span>” 这一节,特别是其中的子标题 “<span data-type="resource_reading_textrange" data-resource-subitem-id="f1390cd4" data-range-start="你可能会好奇:为什么我们需要" data-range-end="章节中有更详细的讨论。">为什么要使用 ref?</span>”。你无需关注代码示例的具体实现,只需理解其背后的原理即可。

简单来说,当你访问 myRef.value 时,Vue 会“记录”下来:“哦,这个组件的这部分依赖于 myRef”。当 myRef.value 被修改时,Vue 就会“通知”所有依赖它的地方去更新。普通的变量无法提供这种追踪能力。


2. 使用 ref 创建响应式数据

ref 通常用于声明原始类型(如 String, Number, Boolean)的响应式数据。当然,它也可以用于对象。ref 会将传入的值包装在一个特殊的对象中,这个对象只有一个 .value 属性,指向你传入的原始值。

要修改或访问 ref 的值,在 <script> 部分,你需要通过 .value 属性。

import { ref } from 'vue'

// 声明一个响应式变量
const counter = ref(0)

// 访问值
console.log(counter.value) // 输出: 0

// 修改值
counter.value++
console.log(counter.value) // 输出: 1

然而,在模板 <template> 中使用时,Vue 会自动“解包”(unwrap),你不需要写 .value,可以直接使用。

<template>
  <button @click="counter++">{{ counter }}</button>
</template>

接下来,观看一个简短的视频,看看如何在实际项目中应用 ref,包括与 v-model 结合实现双向数据绑定。

Vue 3 Composition API Tutorial #2 - Data, Refs & Reactive Objects

这个视频会通过一个计数器示例,生动地演示如何使用 ref 创建和修改响应式数据,以及如何将它与输入框进行双向绑定。

请在视频大约 24 秒处开始观看 ref 基础演示部分。


3. 使用 reactive 组织复杂数据

当你的数据结构变得复杂,比如一个包含多个字段的表单对象或一个用户资料对象时,把每个字段都声明成一个 ref 会显得很繁琐。这时,reactive 就派上用场了。

reactive 专门用于将对象类型(Object, Array, Map, Set)的数据转化为响应式对象。与 ref 不同,你不需要通过 .value 来访问或修改它的属性。

import { reactive } from 'vue'

// 声明一个响应式对象
const formState = reactive({
  username: '',
  password: ''
})

// 访问和修改属性
formState.username = 'testuser'

console.log(formState.username) // 输出: testuser

在模板中也一样,直接访问属性即可:

<template>
  <input v-model="formState.username" placeholder="Username">
</template>

现在,继续观看刚才的视频,看看如何将之前的 ref 示例重构为使用 reactive。

Vue 3 Composition API Tutorial #2 - Data, Refs & Reactive Objects

视频的这一部分将演示如何使用 reactive 来组织相关的多个数据,并解释了它与 ref 在使用上的主要区别(例如,不需要 .value)。

请在视频将近四分钟处,观看使用 reactive 对象的部分。


4. ref vs. reactive:选择与权衡

现在你已经了解了 ref 和 reactive 的基本用法。它们之间有何区别?该如何选择?

特性 ref() reactive()
接受的参数 任何类型的值 只能是对象类型(Object, Array, 等)
访问方式(脚本中) 通过 .value 属性 直接访问属性
模板中访问 直接访问(自动解包) 直接访问属性
核心机制 创建一个包含 .value 的特殊对象 返回一个原始对象的响应式代理 (Proxy)

reactive 的一个重要限制:

reactive 创建的响应式对象不能被直接替换,否则会失去响应性。同时,对 reactive 对象进行解构也会导致其属性失去响应性。

import { reactive } from 'vue'

let state = reactive({ count: 0 })

// 错误示范:这会使 state 失去响应性
// state = reactive({ count: 1 })

// 错误示范:解构出的 count 是一个普通数字,不再具有响应性
let { count } = state
count++ // 这不会影响 state.count

为了深入理解这些限制,请阅读官方文档的说明。这对于避免在实际开发中踩坑至关重要。

响应式基础 - Vue.js

请阅读 Vue 官方文档中关于 reactive() 的部分,特别是它的局限性。这将帮助你理解为什么在某些场景下 ref 是更推荐的选择。

请阅读 “reactive()” 这一节,重点关注 “reactive() 的局限性” 部分。

经验法则:

  • 当你需要一个响应式的原始值(字符串、数字等),用 ref。
  • 当你需要一个响应式的对象或数组,并且希望将一组相关数据组织在一起时,用 reactive。
  • 为了避免 reactive 的解构限制,一个常见的做法是统一使用 ref,即使是对于对象。Vue 社区对此有不同的偏好,但 ref 在通用性和一致性上表现更好。例如 const user = ref({ name: 'John' })。

5. 实战演练:构建一个简单的响应式表单

理论结合实践是最好的学习方式。让我们用 reactive 来构建一个简单的登录表单,这是一个非常常见的场景。

下面这篇来自掘金社区的文章提供了一个清晰的例子。

Vue 3 Composition API实战:构建响应式表单与验证 - 稀土掘金

这篇文章展示了如何利用 reactive 来管理一个表单的状态。我们将关注其构建响应式表单的部分。

请阅读文章的“二、构建响应式表单”部分中的响应式表单介绍。注意作者是如何使用 reactive 来创建一个 form 对象,并用 v-model 将它与 <input> 元素绑定的。

根据文章中的示例,一个使用 <script setup> 的完整组件代码如下所示。你可以尝试在自己的项目中创建这样一个组件来感受一下:

<!-- UserForm.vue -->
<template>
  <form @submit.prevent="submitForm">
    <div>
      <label for="username">用户名:</label>
      <input id="username" v-model="form.username" type="text" />
    </div>
    <div>
      <label for="email">电子邮件:</label>
      <input id="email" v-model="form.email" type="email" />
    </div>
    <button type="submit">提交</button>
  </form>
  <p>当前输入:{{ form }}</p>
</template>

<script setup>
import { reactive } from 'vue';

// 使用 reactive 创建一个包含多个字段的响应式对象
const form = reactive({
  username: '',
  email: '',
});

function submitForm() {
  // 在提交时可以访问到最新的表单数据
  console.log('表单已提交:', form);
  alert(`你好, ${form.username}! 你的邮箱是 ${form.email}`);
}
</script>

这个例子完美地展示了 reactive 的优势:将所有表单相关的字段聚合在一个 form 对象中,代码结构清晰且易于管理。



总结

恭喜你完成了全栈课程的第一课!让我们快速回顾一下核心要点:

  • 响应式基础:Vue 通过响应式系统自动同步数据和视图,ref 和 reactive 是组合式 API 中实现这一目标的核心工具。
  • ref():适用于任何数据类型,尤其适合原始值。在 <script> 中通过 .value 访问,在 <template> 中则可以直接使用。
  • reactive():专为对象类型设计,用于组织相关联的数据。访问属性时无需 .value,但要注意它存在不能被整个替换和解构后会丢失响应性的限制。
  • <script setup>:是 Vue 3 中推荐的组件语法,它极大地简化了组合式 API 的使用,使代码更简洁。

展望未来

在今天的课程中,我们学习了如何构建单个的响应式组件。然而,一个完整的应用是由多个页面和组件构成的。在下一节课中,我们将学习使用 Vue Router 来配置多页面路由。你将了解到如何创建不同的“页面”组件,并实现用户在这些页面之间的顺畅跳转,为我们的全栈项目搭建起基本的前端骨架。