VUE3常用API

toRef与toRefs

toRef

作用:创建一个ref对象,其value值指向另一个对象中的某个属性
语法:const name = toRef(person,'name')
应用:要将响应式对象中的某个属性单独提供给外部使用时
扩展:toRefs与toRef功能一致,但可以批量创建多个ref对象,语法:toRefs(person)

---

<template>
    <h4>{{person}}</h4>
    <h2>姓名:{{name}}</h2>
    <h2>年龄:{{age}}</h2>
    <h2>薪水:{{job.j1.salary}}</h2>
    <button @click="name+='~'">修改姓名</button>
    <button @click="age++">增长年龄</button>
    <button @click="job.j1.salary++">增长薪水</button>
</template>

<script>
import {reactive, ref, toRef,toRefs} from 'vue'
export default {
    name:'demo',
    setup(){
        // 数据
        let person = reactive({
            name:'张三',
            age:18,
            job:{
                j1:{
                    salary:20
                }
            }
        })

        const name1 = person.name 
        console.log('%%%',name1)

        const name2 = toRef(person,'name')
        console.log('###',name2)
        // 返回一个对象(常用)
        return {
            person,
            ...toRefs(person)
        }
  },
}
</script>

shallowReactive 与 shallowRef

shallowReactive：只处理对象最外层的属性的响应式(浅响应式)
shallowRef:只处理基本类型数据的响应式,不进行对象的响应式处理
什么时候使用?
    如果有一个对象数据,结构比较深,但变化的只是外层属性变化========>shallowReactive
    如果有一个对象数据,后续功能不会修改该对象中的属性,而是生新的对象来替换=========>shallowRef

---

<script>
import {reactive, ref, toRef,toRefs,shallowReactive,shallowRef} from 'vue'
export default {
    name:'demo',
    setup(){
        // 数据
        // let person = shallowReactive({  // 只考虑第一层数据的响应式
        let person = reactive({ 
            name:'张三',
            age:18,
            job:{
                j1:{
                    salary:20
                }
            }
        })

        let x = shallowRef({
            y:0
        })

        const name1 = person.name 
        console.log('%%%',name1)

        const name2 = toRef(person,'name')
        console.log('###',name2)
        // 返回一个对象(常用)
        return {
            x,
            person,
            ...toRefs(person)
        }
  },
}
</script>

readonly 与 shallowReadonly

readonly:让一个响应式数据变为只读(深只读)
shallowReadonly:让一个响应式数据变为只读(浅只读)
应用场景:不希望数据被修改时

---

<script>
import {reactive, ref,toRefs,readonly,shallowReadonly} from 'vue'
export default {
    name:'demo',
    setup(){
        // 数据
        let person = reactive({ 
            name:'张三',
            age:18,
            job:{
                j1:{
                    salary:20
                }
            }
        })

        // person = readonly(person)
        // person = shallowReadonly(person)
        
        let sum = ref(0)

        // sum = readonly(sum)
        // sum = shallowReadonly(sum)

        // 返回一个对象(常用)
        return {
            sum,
            ...toRefs(person)
        }
  },
}
</script>

toRaw 与 markRaw

toRaw:
    作用:将一个由reactive生成的响应式对象转为普通对象
    使用场景:用于读取响应式对象的普通对象,对这个普通对象的所有操作,不会引起页面刷新
markRaw:
    作用:标记一个对象,使其永远不会再成为响应式对象
    应用场景:
        1.有些值不应被设置成响应式时,例如复杂的第三方类库等
        2.当渲染具有不可变数据源的大列表时,跳过响应式转换可以提高性能

---

<script>
import {reactive, ref,toRefs, toRaw, markRaw} from 'vue'
export default {
    name:'demo',
    setup(){
        // 数据
        let sum = ref(0)
        let person = reactive({ 
            name:'张三',
            age:18,
            job:{
                j1:{
                    salary:20
                }
            }
        })

        function showRawPerson(){
            let p = toRaw(person)
            console.log(p)
            // console.log(person)
        }

        function addCar(){
            let car = {
                name:'宝马',
                price:40
            }

            person.car = markRaw(car) 
            console.log(person.car)
        }

        function changePrice(){
            person.car.price++
            console.log(person.car.price)
        }

        // 返回一个对象(常用)
        return {
            sum,
            person,
            ...toRefs(person),
            showRawPerson,
            addCar,
            changePrice
        }
  },
}
</script>

customRef

作用:创建一个自定义的ref,并对其依赖项跟踪和更新触发进行显式控制

---

实现防抖效果
<template>
  <input type="text" v-model="keyWord">
  <h3>{{keyWord}}</h3>
</template>
<script>
import {customRef, ref} from 'vue'
export default {
  name: 'App',
  setup(){
    // 自定义一个ref----myRef
    function myRef(value){
      let timer
      return customRef((track,trigger)=>{
        return {
          get(){
            console.log(`有人从myRef这个容器中读取数据了,我把${value}给他了`)
            track() //通知Vue追踪value的变化(提前和get商量一下,让他认为这个value是有用的)
            return value
          },
          set(val){
            console.log(`有人把myRef这个容器中数据修改为:${val}`)
            // keyWord.value = val
            clearTimeout(timer)
            timer = setTimeout(()=>{
              value = val
              trigger() //通知Vue去重新解析模板
            },500)
          }
        }
      })
    }
    // let keyWord = ref('hello') // 使用Vue提供的ref
    let keyWord = myRef('hello') //使用自定义的ref
    return {
      keyWord
    }
  }
}
</script>

provide与inject

作用:实现祖与后代组件间通信
套路:父组件有一个provide选项来提供数据,子组件有一个inject选项来开始使用这些数据

具体写法

 1.祖组件
        setup(){
            let car = reactive({
                name:'宝马',
                price:'40'
            })
            provide('car',car) //给自己的后代组件传递数据
        }
    2.后代组件中:
        let car = inject('car')
        return {
            car
        }

响应式数据的判断

isRef:检查一个值是否为一个ref对象
isReactive:检查一个对象是否是由reactive创建的响应式代理
isReadonly:检查一个对象是否由readonly创建的只读代理
isProxy:检查一个是否是由reactive或者readonly方法创建的代理