vue3声明响应式状态使用(含ref,reactive,toRef(),toRefs()等)

 更新时间:2024年07月18日 10:42:08   作者:朝阳39  
这篇文章主要介绍了vue3声明响应式状态使用(含ref,reactive,toRef(),toRefs()等),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

Vue 3 中的数据基于 JavaScript Proxy (代理) 实现响应式

( vue2 中的数据通过 Object.defineProperty() 方法和对数组变异方法的重写,实现响应式)

选项式 API

用 data 选项声明响应式状态,值为返回一个对象的函数。

  • 在创建组件实例的时候会调用此函数
  • 函数返回的对象会用响应式系统进行包装
  data() {
    return {
      count: 1
    }
  },

注意事项

  • data 的顶层属性避免用 $_开头(Vue 在组件实例上暴露的内置 API 使用 $ 作为前缀,也为内部属性保留 _ 前缀。)
  • 未在data中定义的组件实例新属性,无法触发响应式更新。
  • 始终通过 this 来访问响应式状态
  data() {
    return {
      someObject: {}
    }
  },
  mounted() {
    const newObject = {}
    this.someObject = newObject

    console.log(newObject === this.someObject) // false
  }

这里原始的 newObject 不会变为响应式。

组合式 API

方式一 ref 【推荐】

所有类型的数据,都推荐使用 ref 声明响应式。

import { ref } from 'vue'

// 定义一个初始值为数字 0 的响应式变量 countRef  
const countRef = ref(0)

// 得到一个带有 .value 属性的 ref 对象
console.log(countRef ) // { value: 0 }

// 通过 .value 访问 ref 响应式变量的值
console.log(countRef.value) // 0

// 通过 .value 修改 ref 响应式变量的值
countRef.value++
  • 参数为响应式变量的初始值(当参数是一个对象时,ref() 会在内部调用reactive()
  • 返回一个带有 .value 属性的 ref 对象
  • 建议变量名以Ref为后缀,以便识别其是一个 ref 对象
  • 模板中使用时,ref 对象会自动解包,无需使用.value
<button @click="countRef++">
  {{ countRef }}
</button>
  • ref 对象在作为响应式对象的属性被访问或修改时会自动解包。
const countRef = ref(0)

// reactive 的用法详见下文
const state = reactive({
  count:countRef 
})

console.log(state.count) // 0 ,无需写成 state.count.value

state.count = 1 // 无需写成 state.count.value
console.log(countRef .value) // 1
  • ref 的另一个功能是获取模板引用(即 vue2 中的 this.$refs)
<script setup>
import { ref, onMounted } from 'vue'

// 获取到 ref 属性为 input 的模板元素的引用(ref 变量名必须和模板里的 ref 属性值相同)
const input = ref(null)

// 生命周期:DOM 挂载完成
onMounted(() => {
  // input 输入框获得焦点(注意此处需使用.value)
  input.value.focus()
})
</script>

<template>
  <!-- ref 属性为 input 的模板元素 -->
  <input ref="input" />
</template>
  • 为什么需要 ref

因为 vue3 的响应式是通过 proxy 实现的,但 proxy 只能给对象添加响应式,无法给值类型的数据添加响应式,所以需要通过 ref() 函数先将值类型的数据包装成一个带 value 属性的 ref 对象,才能实现值类型数据的响应式。

  • 为什么需要 .value

因为 ref() 函数返回的是一个 ref 对象,响应式变量的值存储在 ref 对象的value 属性中,所以在 js 中读取和修改响应式变量的值的时候,都需要 .value ,但在以下情况中,为了方便使用,vue 对 ref 对象进行了自动解包,所以无需 .value

  • 模板中使用 ref 对象
  • ref 对象作为响应式对象的属性被访问或修改

TS 中给 ref 声明类型

  • ref 会根据初始化时的值推导其类型
// 推导出的类型:Ref<number>
const year = ref(2020)
  • 但比较复杂的数据类型,需用 Ref
import { ref } from 'vue'
import type { Ref } from 'vue'

interface userInfo {
  id: number
  name: String
}

const userList: Ref<userInfo[]> = ref([])

方式二 reactive

用于创建对象类型数据的响应式。

import { reactive } from 'vue'
const state = reactive({ count: 0 })
<button @click="state.count++">
  {{ state.count }}
</button>
  • reactive() 无需对源数据添加类似 ref 的包装,可使对象本身具有响应性
  • reactive() 返回的是一个原始对象的 Proxy,它和原始对象是不相等的
const raw = {}
const proxy = reactive(raw)

// 代理对象和原始对象不是全等的
console.log(proxy === raw) // false

reactive() 的局限性

  • 只能用于对象类型数据 (对象、数组和如 Map、Set 这样的集合类型),不能用于 string、number 或 boolean 这样的值类型数据
  • 替换整个对象会丢失响应式(Vue 的响应式跟踪是通过属性访问实现的),所以只能通过修改属性来修改 reactive() 创建的响应式变量。
  • 解构会丢失响应式
const state = reactive({ count: 0 })

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

其他相关 API

vue 提供了专门的API 来实现在不丢失响应式的情况下,解构响应式对象(reactive 创建),它们不创造响应式 (如 ref , reactive),而是延续响应式 (toRef , toRefs) !

  • toRef()

基于响应式对象上的属性,创建 ref (与源属性保持同步)

  • 第一个参数为 响应式对象(reactive 创建)
  • 第二个参数为 属性名
const state = reactive({
  foo: 1
})

// 基于响应式对象 state 上的属性 foo ,创建 ref
const fooRef = toRef(state, 'foo')

// 更改该 ref 会更新源属性
fooRef.value++
console.log(state.foo) // 2

// 更改源属性也会更新该 ref
state.foo++
console.log(fooRef.value) // 3

vue3.3+ 新增了将值、refs 或 getters 规范化为 refs 的功能,详见官网

https://cn.vuejs.org/api/reactivity-utilities.html#toref

  • toRefs()

将响应式对象转换为每个属性都指向源对象相应属性的 ref 的普通对象

  • 推荐用法:合成函数返回响应式对象时,使用 toRefs,以便解构赋值时不丢失响应式。(详见下文的范例)
const state = reactive({
  foo: 1,
  bar: 2
})

// 得到一个每个属性都是 ref 的普通对象
const stateAsRefs = toRefs(state)
/*
stateAsRefs 的类型:{
  foo: Ref<number>,
  bar: Ref<number>
}
*/

// 源属性改变,Refs 对象里的 ref 属性会同步改变
state.foo++
console.log(stateAsRefs.foo.value) // 2

// Refs 对象里的 ref 属性改变,源属性会同步改变
stateAsRefs.foo.value++
console.log(state.foo) // 3

应用范例:解构对象属性,简化模板引用

<!-- 组合式API -->
<script setup>
import { reactive, toRefs } from "vue";

function getMyInfo() {
  const me = reactive({
    name: "朝阳",
    age: 35,
  });

  // 使用 toRefs 避免丢失响应式
  return toRefs(me);
}

// 通过解构赋值,便于模板中使用
let { name, age } = getMyInfo();

const changeName = () => {
  name.value = "张三";
};
</script>

<template>
  <p>姓名:{{ name }}</p>
  <p>年龄:{{ age }}</p>
  <button @click="changeName">改名</button>
</template>
  • isRef()

判断是否为 ref

let age = ref(35)
if (isRef(age)) {
}
  • isReactive()

判断一个对象是否是由 reactive() 或 shallowReactive() 创建的代理。

  • isProxy()

判断一个对象是否是由 reactive()、readonly()、shallowReactive() 或 shallowReadonly() 创建的代理。

  • unref()

对 ref 对象解包,是 isRef(val) ? val.value : val 的语法糖

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Vue异步请求导致页面数据渲染错误问题解决方法示例

    Vue异步请求导致页面数据渲染错误问题解决方法示例

    这篇文章主要为大家介绍了Vue中异步请求导致页面数据渲染错误问题解决方法示例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • vue-cli 3如何使用vue-bootstrap-datetimepicker日期插件

    vue-cli 3如何使用vue-bootstrap-datetimepicker日期插件

    这篇文章主要介绍了vue-cli 3如何使用vue-bootstrap-datetimepicker日期插件,帮助大家更好的理解和学习使用vue框架,感兴趣的朋友可以了解下
    2021-02-02
  • Vue3.0监听器watch与watchEffect详解

    Vue3.0监听器watch与watchEffect详解

    在 Vue 3 中,watch 仍然是一种用于监听数据变化并执行相应操作的方式,不过在组合式 API 中,watch 的使用方式与选项式 API 略有不同,这篇文章主要介绍了Vue3.0监听器watch与watchEffect,需要的朋友可以参考下
    2023-12-12
  • vue组件name的作用小结

    vue组件name的作用小结

    大家在写vue项目的时候会遇到给组件的各种命名,接下来通过本文给大家分享vue组件name的作用小结,感兴趣的朋友跟随脚本之家小编一起看看吧
    2018-05-05
  • 基于Vue3实现无限滚动组件的示例代码

    基于Vue3实现无限滚动组件的示例代码

    如果你在社交媒体上停留的时间过长,那么,你所在的网站很可能正在使用无限滚动组件。这篇文章教你利用Vue3实现无限滚动组件,感兴趣的可以参考一下
    2022-09-09
  • Vue中一个组件调用其他组件的方法详解(非父子组件)

    Vue中一个组件调用其他组件的方法详解(非父子组件)

    vue中最常见子父组件产值,大家一定都很熟悉,最近项目中碰到非父组件中调用子组件方法的问题,这篇文章主要给大家介绍了关于Vue中一个组件调用其他组件的方法(非父子组件),需要的朋友可以参考下
    2022-10-10
  • vue项目使用element ui详解

    vue项目使用element ui详解

    文章介绍了如何在Vue项目中使用Element Plus UI框架,包括创建项目、安装Element Plus、在项目中引入和使用Element组件以及如何修改样式属性
    2025-12-12
  • vue3 Vite 进阶rollup命令行使用详解

    vue3 Vite 进阶rollup命令行使用详解

    这篇文章主要介绍了vue3 Vite 进阶rollup命令行使用详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • vue3实现图片瀑布流展示效果实例代码

    vue3实现图片瀑布流展示效果实例代码

    这篇文章主要介绍了vue3实现图片瀑布流展示效果的相关资料,该组件可以调整列数、支持懒加载、自定义每页滚动数量、高度和点击效果,作者展示了组件的效果,并详细说明了实现方法,包括组件的创建和依赖的工具库,需要的朋友可以参考下
    2024-11-11
  • 使用vuex的state状态对象的5种方式

    使用vuex的state状态对象的5种方式

    本文给大家介绍了使用vuex的state状态对象的5种方式,给大家贴出了我的vuex的结构,感兴趣的朋友跟随脚本之家小编一起学习吧
    2018-04-04

最新评论