vue toRefs 与 toRef

‌‌toRef与‌toRefs是Vue3中用于解构响应式对象的实用工具函数,主要解决reactive对象属性失去响应性的问题。‌ toRef针对单个属性转换,toRefs则批量处理对象属性。‌‌

toRef与toRefs的核心区别

  • toRef‌:将响应式对象(‌reactive对象)的单个属性转为独立的ref对象,保持与源属性的双向绑定关系(修改ref值会同步修改源对象)。‌‌

  • toRefs‌:将整个响应式对象的所有属性批量转换为普通对象,每个属性都是独立ref对象,常用于解构后保持响应性。‌‌

使用场景对比

  • ‌toRef适用场景‌:
    • 需要单独操作某个深层嵌套属性时。
    • 在组合式函数中返回特定属性给外部使用。‌‌
  • ‌toRefs适用场景‌:
    • 解构reactive对象时保留所有属性的响应性。
    • 在模板中直接展开对象属性避免冗余代码。‌‌

与reactive/ref的关联

1‌、与reactive的关系‌:

  • toRef/toRefs必须基于‌reactive创建的响应式对象使用。
  • 普通对象使用这两个API无法获得响应性。‌‌

2‌、与ref的差异‌:

  • ‌ref会拷贝数据并创建新引用,toRef/toRefs直接引用源数据。
  • 修改ref值不会影响原始数据,而toRef的修改会同步到源对象。‌‌

toRef 示例:

复制代码
<template>
  <div>
    <p>name: {{ name }}</p>
    <p>age: {{ age }}</p>
    <button @click="updateName">修改姓名</button>
    <button @click="updateAge">修改年龄</button>
  </div>
</template>

<script setup lang="ts">
import { reactive, toRef } from 'vue';
let person = reactive({ name: 'zs', age: 20 });
let name = toRef(person, 'name'); // 单个属性转ref
let age = toRef(person, 'age');

function updateName() {
  name.value += '~~~'; // 修改ref值,同步更新person.name
};
function updateAge() {
  age.value += 1; // 修改ref值,同步更新person.age
};
</script>

toRefs 示例:

复制代码
<template>
  <div>
    <p>name: {{ name }}</p>
    <p>age: {{ age }}</p>
    <button @click="updateName">修改姓名</button>
    <button @click="updateAge">修改年龄</button>
  </div>
</template>

<script setup lang="ts">
import { reactive, toRefs } from 'vue';
let person = reactive({ name: 'zs', age: 20 });
// let name = toRef(person, 'name'); // 单个属性转ref
// let age = toRef(person, 'age');
 const { name, age } = toRefs(person); // 批量转换所有属性

function updateName() {
  name.value += '--'; // 修改ref值,同步更新person.name
};
function updateAge() {
  age.value += 1; // 修改ref值,同步更新person.age
};
</script>
相关推荐
专吃海绵宝宝菠萝屋的派大星17 小时前
使用Dify对接自己开发的mcp
java·服务器·前端
爱分享的阿Q17 小时前
Rust加WebAssembly前端性能革命实践指南
前端·rust·wasm
蓝黑202017 小时前
Vue的 value=“1“ 和 :value=“1“ 有什么区别
前端·javascript·vue
小李子呢021117 小时前
前端八股6---v-model双向绑定
前端·javascript·算法
He少年17 小时前
【基础知识、Skill、Rules和MCP案例介绍】
java·前端·python
史迪仔011217 小时前
[QML] QML IMage图像处理
开发语言·前端·javascript·c++·qt
AI_Claude_code17 小时前
ZLibrary访问困境方案四:利用Cloudflare Workers等边缘计算实现访问
javascript·人工智能·爬虫·python·网络爬虫·边缘计算·爬山算法
AwesomeCPA17 小时前
Miaoduo MCP 使用指南(VDI内网环境)
前端·ui·ai编程
前端大波17 小时前
前端面试通关包(2026版,完整版)
前端·面试·职场和发展
qq_4335021818 小时前
Codex cli 飞书文档创建进阶实用命令 + Skill 创建&使用 小白完整教程
java·前端·飞书