vue3-其余新增API

shallowRef

创建一个响应式数据，但只对顶层属性进行响应式处理,只跟踪引用值的变化，不关心值内部的属性变化

import {shallowRef} from "vue"
import UserInfo from "@/components/UserInfo.vue";


let name = shallowRef("vue")
let info = shallowRef({name:"html"})

console.log(name.value) // 响应式数据

// shallowRef只处理第一层响应式数据，info.value就已经是一层了，不处理value.name
console.log(info.value.name) // 非响应式数据

shallowReactive

创建一个浅层响应式对象，只会使对象的最顶层属性变成响应式的，对象内部的嵌套属性则不会变成响应式的

import {shallowReactive} from "vue"
import UserInfo from "@/components/UserInfo.vue";


 let info = shallowReactive({name:"html",address:{"email":123}})

console.log(info.name) // 响应式数据

console.log(info.address.email) // 非响应式数据

通过使用 shallowRef和 shallowReactive来绕开深度响应。浅层式 API 创建的状态只在其顶层是响应式的，对所有深层的对象不会做任何处理，避免了对每一个内部属性做响应式所带来的性能成本，这使得属性的访问变得更快，可提升性能

readonly

用于创建一个对象的深层只读副本

对象的所有嵌套属性都将变为只读,任何尝试修改这个对象的操作都会被阻止（在开发模式下，还会在控制台中发出警告）

用于创建不可变的状态快照、保护全局状态或配置不被修改

import {reactive, readonly} from "vue"
import UserInfo from "@/components/UserInfo.vue";


let info = reactive({name:"html",address:{"email":123}})


let address = readonly(info.address)

// 修改info.address 会同步修改address
// 但是修改address会被拒绝，address只读

shallowReadonly

与 readonly 类似，但只作用于对象的顶层属性,只将对象的顶层属性设置为只读，对象内部的嵌套属性仍然是可变的,适用于只需保护对象顶层属性的场景

import {reactive, shallowReadonly} from "vue"
import UserInfo from "@/components/UserInfo.vue";


let info = reactive({name:"html",address:{"email":123}})


let info1 = shallowReadonly(info)

// 修改info会同步修改info1
// 但是修改info1会被拒绝，但是可以修改info.1.address

toRaw

用于获取一个响应式对象的原始对象， toRaw 返回的对象不再是响应式的，不会触发视图更新

官网描述：这是一个可以用于临时读取而不引起代理访问/跟踪开销，或是写入而不触发更改的特殊方法。不建议保存对原始对象的持久引用，请谨慎使用。

在需要将响应式对象传递给非 Vue 的库或外部系统时，使用 toRaw 可以确保它们收到的是普通对象

import {reactive, toRaw} from "vue"
import UserInfo from "@/components/UserInfo.vue";


// 响应式
let info = reactive({name:"html",address:{"email":123}})


// rawInfo变成了原始数据，非响应式数据
let rawInfo = toRaw(info)

markRaw

标记一个对象，使其永远不会变成响应式的

// 定义info
import {markRaw, reactive} from "vue";

let info = {name: "vue", ext: {email: 123}}

// 转换响应式info
let reactiveInfo = reactive(info)


let markRawInfo = markRaw(info)

// 不能转换成响应式
let info2 = reactive(markRawInfo)

customRef

自定义ref，使用Vue的ref定义响应式数据，数据发生变化页面会即时更新，而自定义的ref，可以对其依赖项跟踪和更新触发进行逻辑控制

import {customRef} from "vue";



let str:string = "hello word"

// 创建自定义ref响应式数据，参数是一个回调函数,返回一个对象
// 接收两个参数:track,trigger
let info = customRef((track, trigger) => {

  return {
    // info被读取的时候调用
    get() {
      // 让vue持续追踪数据，发生变化就去更新
      track()
      return str

    },
    // info被修改的时候调用
    set(value:string) {

      str = value
      // 前面可以有一些其他处理，处理完再更新
      // 通知vue页面更新
      trigger()
    }
  }

})