Vue3从零开始——掌握setup、ref和reactive函数的奥秘

詩筠2024-08-07 23:54

文章目录

    • [一、Vue 3 组合式 API 概述](#一、Vue 3 组合式 API 概述)
    • [二、`setup`​ 函数的基本使用](#二、setup 函数的基本使用)
      • [2.1 `setup`​ 函数的特点](#2.1 setup 函数的特点)
      • [2.2 `setup`​ 函数的基本结构](#2.2 setup 函数的基本结构)
      • [2.3 实现一个简单的小demo](#2.3 实现一个简单的小demo)
    • [三、`ref`​ 函数的功能和应用](#三、ref 函数的功能和应用)
      • [3.1 `ref`​函数介绍](#3.1 ref函数介绍)
      • [3.2 基本使用](#3.2 基本使用)
        • [3.2.1 定义`ref`​数据](#3.2.1 定义ref数据)
        • [3.2.2 修改响应式变量](#3.2.2 修改响应式变量)
      • [3.3 使用`ref`​函数实现计数器](#3.3 使用ref函数实现计数器)
    • [四、`reactive`​ 函数的功能和应用](#四、reactive 函数的功能和应用)
      • [4.1 `reactive`​ 函数介绍](#4.1 reactive 函数介绍)
      • [4.2 基本使用](#4.2 基本使用)
      • [4.3 使用`reactive`​函数实现计数器](#4.3 使用reactive函数实现计数器)
      • [4.4 `reactive`​函数的的局限性](#4.4 reactive函数的的局限性)
    • [五、`ref`​ 与 `reactive`​ 的区别](#五、ref 与 reactive 的区别)
      • [5.1 主要区别](#5.1 主要区别)
      • [5.2 `ref`​ 适合的场景](#5.2 ref 适合的场景)
      • [5.3 `reactive`​ 适合的场景](#5.3 reactive 适合的场景)
      • [5.4 Vue社区观点](#5.4 Vue社区观点)
    • 六、总结

一、Vue 3 组合式 API 概述

在 Vue 3 中，引入了组合式 API（Composition API） ，这使得开发者可以更灵活地组织代码逻辑，并提升了组件的复用性和可维护性。相比于 Vue 2 中的选项式 API，组合式 API 提供了一种更具功能性的方式来构建应用。

主要优点：

  • 逻辑复用和组织：通过组合函数可以更清晰地组织代码逻辑，避免在生命周期函数中写大量逻辑。
  • 更好的 TypeScript 支持：组合式 API 天然地支持 TypeScript，这使得类型推断和类型检查变得更加轻松。
  • 性能优化：组合式 API 的实现方式在某些场景下可以带来性能上的提升。

二、setup​ 函数的基本使用

setup​ 函数是 Vue 3 组件中使用组合式 API 的起点，它是一个新增加的组件选项，所有的组合式 API 的逻辑都需要在这个函数中书写。

2.1 setup​ 函数的特点

  • 从组件生命周期来看，在beforeCreate之前调用，因此它没有 this 绑定。
  • 函数中 this 不是组件实例，是 undefined。
  • 返回一个对象，该对象将被合并到组件的 data 中，可以在模板中直接使用。

2.2 setup​ 函数的基本结构

html 复制代码 
<template>
  <div>
    <!-- 绑定在模板中的变量和方法 -->
  </div>
</template>

<script>
import { ref, reactive } from 'vue';

export default {
  setup() {
    // 在这里定义响应式变量和方法

    return {
      // 返回需要在模板中使用的变量和方法
    };
  },
};
</script>

<style scoped>
/* 样式部分 */
</style>

2.3 实现一个简单的小demo

html 复制代码 
<template>
    <div>
        <p @click="show()">{{ msg }}</p>
    </div>
</template>

<script>

export default {
    setup() {
        console.log("setup 函数执行了");

        let msg = 'Hello World';

        function show(){
            console.log("show 函数执行了");
        }

        // 返回定义的变量和函数
        return {
            msg,
            show
        };
    },
    beforeCreate() {
        console.log("beforeCreate 函数执行了");
    },
};
</script>

<style scoped>
button {
    margin: 5px;
    padding: 10px 20px;
    background-color: #4caf50;
    color: white;
    border: none;
    border-radius: 5px;
    cursor: pointer;
}

button:hover {
    background-color: #45a049;
}


p {
    font-size: 18px;
}
</style>

​

三、ref​ 函数的功能和应用

3.1 ref​函数介绍

ref​ 函数用于创建一个持有单个值的响应式引用。它适用于基本数据类型（如字符串、数字、布尔值）和不需要深度响应的数据结构。通过 ref​ 函数，我们可以在 Vue 组件中创建简单的响应式数据。

主要特点：

  • 基本类型响应性：为基本数据类型创建响应式状态。
  • 引用式访问 ：通过 .value 属性访问和修改值。
  • 适用于 DOM 引用：可以用于 DOM 元素的引用。

3.2 基本使用

3.2.1 定义ref​数据
javascript 复制代码 
import { ref } from 'vue';

export default {
  setup() {
	// 创建响应式数据
	const count = ref(0); 
    const message = ref('Hello, Vue 3!');
    const isVisible = ref(true);
  
    return {
	  count,
      message,
      isVisible,
    };
  },
};
3.2.2 修改响应式变量

要修改 ref​ 创建的响应式变量，需要使用 .value​ 属性：

javascript 复制代码 
count.value++; // 增加 count
count.value = 10; // 设置 count 的值

注意：当在Vue的模板（template​）中使用时，ref​ 的值可以直接使用，无需显式调用 .value​：

html 复制代码 
<template>
  <div>
    <p>{{ count }}</p>
    <button @click="count++">增加</button>
  </div>
</template>

3.3 使用ref​函数实现计数器

应用需求：

  • 显示当前计数。
  • 提供按钮增加计数。
  • 提供按钮重置计数。
html 复制代码 
<template>
    <div>
        <p>当前计数：{{ count }}</p>
        <button @click="increment">增加</button>
        <button @click="reset">重置</button>
    </div>
</template>

<script>
import { ref } from 'vue';

export default {
    setup() {
        console.log("setup 函数执行了");

        // 创建一个响应式对象
        const count = ref(0);

        // 增加计数
        function increment() {
            count.value++;
            console.log("count = " + count.value);
          
        }

        // 重置计数
        function reset() {
            count.value = 0;
        }

        return {
            count,
            increment,
            reset,
        };
    },
    beforeCreate() {
        console.log("beforeCreate 函数执行了");
    },
};
</script>

<style scoped>
button {
    margin: 5px;
    padding: 10px 20px;
    background-color: #4caf50;
    color: white;
    border: none;
    border-radius: 5px;
    cursor: pointer;
}

button:hover {
    background-color: #45a049;
}


p {
    font-size: 18px;
}
</style>

代码解读：

  1. 创建响应式变量 ：
    • 使用 ref 创建一个响应式变量 count实现记录数字。ref(0) 表示将初始值设置为 0。
  2. 定义方法 ：
    • increment 方法 ：用于增加计数值。在函数内部，通过 count.value++ 来递增计数器，并在控制台中输出新的计数值。
    • reset 方法 ：用于重置计数值。将 count.value 设为 0 来重置计数器。
  3. 组件返回 ：
    • return ：返回 count 和方法 increment、reset，使其在模板中可以直接访问，这一步非常重要！！
  4. 模板绑定 ：
    • {``{ count }} ：在模板中使用双花括号语法绑定 count，动态显示当前计数值。
    • @click ：绑定 button 元素的点击事件到 increment 和 reset 函数上，实现按钮点击后对计数值的增加和重置。
  5. 生命周期钩子 ：
    • beforeCreate ：输出消息以便于理解setup函数的执行顺序。

​

四、reactive​ 函数的功能和应用

4.1 reactive​ 函数介绍

reactive​ 是 Vue 3 提供的一个 API，用于创建深度响应式对象。与 ref​ 不同，ref​ 适用于基本数据类型，而 reactive​ 更适用于对象、数组等复杂数据结构。

主要特点：

  • 创建深度响应式的数据对象。
  • 自动跟踪依赖变化并更新视图。
  • 可以结合 toRefs 解构成多个响应式引用。

4.2 基本使用

javascript 复制代码 
import { reactive } from 'vue';

export default {
  setup() {
    // 创建响应式对象
    const state = reactive({
      count: 0,
      message: 'Hello, Vue 3!',
    });

    // 方法示例
    function increment() {
      state.count++;
    }

    return {
      state,
      increment,
    };
  },
};

在上面的代码中，我们使用 reactive​ 创建了一个响应式对象 state​，其中包含了两个属性：count​ 和 message​。increment​ 函数可以用来增加 count​ 的值。

‍

4.3 使用reactive​函数实现计数器

应用需求：

  • 显示当前计数。
  • 提供按钮增加计数。
  • 提供按钮重置计数。
html 复制代码 
<template>
  <div>
    <h1>{{ state.title }}</h1>
    <p>当前计数：{{ state.count }}</p>
    <button @click="increment">增加</button>
    <button @click="reset">重置</button>
  </div>
</template>

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

export default {
  setup() {
    // 创建一个响应式对象
    const state = reactive({
      count: 0,
      title: '计数器应用',
    });

    // 增加计数
    function increment() {
      state.count++;
    }

    // 重置计数
    function reset() {
      state.count = 0;
    }
	// 暴露定义的数据和函数
    return {
      state,
      increment,
      reset,
    };
  },
};
</script>

<style scoped>
button {
  margin: 5px;
  padding: 10px 20px;
  background-color: #4caf50;
  color: white;
  border: none;
  border-radius: 5px;
  cursor: pointer;
}

button:hover {
  background-color: #45a049;
}

h1 {
  color: #333;
}

p {
  font-size: 18px;
}
</style>

代码解读：

跟前面的其实差不多，只不过用法上有一点区别，其他其实差别并不大。

  1. 创建响应式变量 ：使用 ref 创建两个响应式变量 count 和 title。
  2. 定义方法 ：定义 increment 和 decrement 函数，用于增加和减少计数。
  3. 模板绑定 ：在模板中使用 {``{ }} 绑定响应式变量，并通过 @click 指令绑定事件处理函数。

​

4.4 reactive​函数的的局限性

参考自：https://cn.vuejs.org/guide/essentials/reactivity-fundamentals.html#reactive

reactive()​ API 有一些局限性：

  1. 有限的值类型 ：它只能用于对象类型 (对象、数组和如 Map​、Set​ 这样的集合类型)。它不能持有如 string​、number​ 或 boolean​ 这样的原始类型。

  2. 不能替换整个对象 ：由于 Vue 的响应式跟踪是通过属性访问实现的，因此我们必须始终保持对响应式对象的相同引用。这意味着我们不能轻易地"替换"响应式对象，因为这样的话与第一个引用的响应性连接将丢失：

    js

    javascript 复制代码 
    let state = reactive({ count: 0 })

// 上面的 ({ count: 0 }) 引用将不再被追踪
// (响应性连接已丢失！)
state = reactive({ count: 1 })

  3. 对解构操作不友好 ：当我们将响应式对象的原始类型属性解构为本地变量时，或者将该属性传递给函数时，我们将丢失响应性连接：

    js

    javascript 复制代码 
    const state = reactive({ count: 0 })

// 当解构时，count 已经与 state.count 断开连接
let { count } = state
// 不会影响原始的 state
count++

// 该函数接收到的是一个普通的数字
// 并且无法追踪 state.count 的变化
// 我们必须传入整个对象以保持响应性
callSomeFunction(state.count)

由于这些限制，我们建议使用 ref()​ 作为声明响应式状态的主要 API。

五、ref​ 与 reactive​ 的区别

Vue 3 提供了两种创建响应式数据的方式：ref​ 和 reactive​。它们在功能上有一些不同，适用于不同的场景。

5.1 主要区别

特性 ​ref​ ​reactive​
用途 创建持有基本类型值的响应式引用 创建深度响应式对象，适合复杂数据结构
访问方式 通过.value​访问和修改 直接访问和修改对象的属性
响应性 基本类型响应性 深度响应性，自动追踪对象属性的变化
适用场景 适用于简单的状态和需要 DOM 引用的场景 适用于多属性对象、数组、复杂数据结构
数据类型支持 只对 object 类型有效 对任意类型有效
使用方式 在 <script>​ 和 <template>​ 中无差别使用 在 <script>​ 和 <template>​ 使用方式不同

5.2 ref​ 适合的场景

  • 用于基本类型或需要独立响应式的变量。适合处理简单的数据类型，如 Number、String、Boolean。
  • 独立的响应式变量：需要单独处理或跟踪的变量。
  • DOM 元素引用：通过 ref 获取和操作 DOM 元素。

5.3 reactive​ 适合的场景

  • 用于复杂的数据结构，如对象或数组。适合处理多属性的对象或需要整个结构响应式的数据。
  • 深度响应：需要自动跟踪嵌套属性变化的数据。

5.4 Vue社区观点

默认都使用 ​ref​ ​ ，当需要分组时使用 ​reactive​​ 。

详细原因可以看：Ref vs. Reactive --- Which is Best? | Michael Thiessen

‍

六、总结

本文主要讲述了 Vue 3 中的 setup​ 函数、ref​函数和 reactive​ 函数的一些基本知识，他们的基本使用语法和如何简单运用实现一个小demo，希望对大家有所帮助☺️。

‍

参考文章：

Ref vs. Reactive --- Which is Best? | Michael Thiessen

【译】Ref vs. Reactive：使用Vue3组合式API该如何选择？

响应式基础 | Vue.js

‍

相关推荐
好久不见的流星2 小时前
[基于 Vue CLI 5 + Vue 3 + Ant Design Vue 4 搭建项目] 04 安装 Vue CLI 5
javascript·vue.js·ecmascript
曈欣2 小时前
vue 控制组件是否显示
前端·javascript·vue.js
nice666603 小时前
CSS的基本语法
java·前端·css·visual studio code
陈在天box3 小时前
《响应式 Web 设计：纯 HTML 和 CSS 的实现技巧》
前端·css·html
爱吃桃子的ICer4 小时前
[UVM]3.核心基类 uvm_object 域的自动化 copy() compare() print() pack unpack
开发语言·前端·ic设计
阿洵Rain5 小时前
【Linux】环境变量
android·linux·javascript
学地理的小胖砸6 小时前
【GEE的Python API】
大数据·开发语言·前端·python·遥感·地图学·地理信息科学
垦利不7 小时前
css总结
前端·css·html
八月的雨季 最後的冰吻7 小时前
C--字符串函数处理总结
c语言·前端·算法
6230_8 小时前
关于HTTP通讯流程知识点补充—常见状态码及常见请求方式
前端·javascript·网络·网络协议·学习·http·html
热门推荐
0151-2 万字长文，深度解读端到端自动驾驶的挑战和前沿022024年高教社杯数学建模国赛C题超详细解题思路分析03【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提04RAG 实践- Ollama+RagFlow 部署本地知识库05【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文062024 高教社杯 数学建模国赛 （A题）深度剖析|“板凳龙” 闹元宵|数学建模完整代码+建模过程全解全析07Coze扣子平台完整体验和实践（附国内和国际版对比）082024年高教杯国赛（C题）数学建模竞赛解题思路|完整代码论文集合092024 年高教社杯全国大学生数学建模竞赛题目-A 题 “板凳龙” 闹元宵10【SCS-CN】SCS-CN模型中CN值的确定