前言

在学习本篇文章之前,可以先了解一下 Vue3 的新特性

本篇文章将介绍 Vue3 中的新增杀器 —— Composition API : 一组低侵入式的、函数式的 API,它使我们能够更灵活地「组合」组件的逻辑。

Composition API 的灵感来自于 React Hooks ,是比 mixin 更强大的存在。它可以提高代码逻辑的可复用性,从而实现与模板的无关性;同时函数式的编程使代码的可压缩性更强。另外,把 Reactivity 模块独立开来,意味着 Vue3.0 的响应式模块可以与其他框架相组合。

composition-api的优越性.png
如上图,在较大组件的编写中, Composition-Api 可以把复杂组件的逻辑抽地更紧凑,而且可以将公共逻辑进行抽取。


setup() 函数

在学习 Composition-Api 之前,我们需要先了解一下 setup() 函数。 setup() 是 Vue3 中的新增内容。它为基于 Composition API 的新特性提供了统一的入口。

在Vue3中,定义 methodswatchcomputeddata数据 等都放在了 setup() 函数中

1. 执行时机

setup()函数会在created()生命周期之前执行。

setup执行时机.png

2. 接收props数据

setup() 函数的第一个参数是 props ,组件接收的 props 数据可以在 setup() 函数内访问到。

setup(props) {
    console.log(props.p1)
}

3. context上下文对象

contextsetup() 的第二个参数,它是一个上下文对象,可以通过 context 来访问Vue的实例 this

setup(props,context) {
    console.log(this)
    console.log(context)
}

setup的context参数.png

注意:在 setup() 函数中访问不到Vue的 this 实例


Composition-Api

一组低侵入式的、函数式的 API,使得我们能够更灵活地「组合」组件的逻辑。

1. reactive()

reactive() 函数接收一个普通的对象,返回出一个响应式对象。

在Vue2.x的版本中,我们只需要在 data() 中定义一个数据就能将它变为响应式数据,在 Vue3.0 中,需要用 reactive 函数或者 ref 来创建响应式数据。

  • 用reactive创建响应式对象

    // 在组件库中引入 reactive
    import { reactive } from '@vue/    composition-api'
    
    setup() {
        // 创建响应式对象
        const state = reactive({
            count:0
        });
    
        // 将响应式对象return出去,暴露给模板使用
        return state;
    }
    
  • 使用响应式对象

    <p>当前的count的值为:{{count}}</p>
    
    <button @click="count++">点击增加count<  button>
    

2. ref()

ref() 函数可以根据给定的来创建一个响应式的数据对象,返回值是一个对象,且只包含一个 .value 属性。

  • 用 ref 创建响应式对象

    // 引入 ref
    import { ref } from '@vue/composition-api'
    
    setup() {
        // 创建响应式对象
        const count = ref(0);
    
        return {
            count
        }
    }
    
  • 使用响应式对象

    <p>当前的count的值为:{{count}}</p>
    
    <button @click="count++">点击增加count</button>
    
  • ref 的注意事项

    1. setup() 函数内,由 ref() 创建的响应式数据返回的是对象,所以需要用 .value 来访问;

      而在 setup() 函数外部则不需要 .value ,直接访问即可。

    2. 可以在 reactive 对象中访问 ref() 函数创建的响应式数据。

    3. 新的 ref() 会覆盖旧的 ref()

  • 选择 reactive 还是 ref

    Vue3 —— 创建响应式数据使用 reactive 还是 ref ?(本周更新)

3. computed()

computed() 用来创建计算属性,返回值是一个 ref() 实例。按照惯例,使用前需要先引入。

  • computed创建只读计算属性

    computed() 传入一个函数,可以得到一个只读的计算属性:

    const count = ref(1)
    
    // 创建一个计算属性,使其值比 count 大 1
    const bigCount = computed(() => count.value + 1)
    
    console.log(bigCount.value) // 输出 2
    bigCount.value++ // error 不可写
    
  • computed创建可读可写计算属性

    const count = ref(1)
    
    // 创建一个 computed 计算属性,传入一个对象
    const bigCount = computed({
        // 取值函数
        get: () => (count.value + 1),
        // 赋值函数
        set: val => {
          count.value = val - 1
        }
    })
    
    // 给计算属性赋值的操作,会触发 set 函数
    bigCount.value = 9
    // 触发 set 函数后,count 的值会被更新
    console.log(count.value) // 8
    

4. readonly()

传入一个响应式对象、普通对象或 ref ,返回一个只读的对象代理。这个代理是深层次的,对象内部的数据也是只读的。

const state = reactive({ count: 0 })

const copy = readonly(state)

watchEffect(() => {
  // 依赖追踪
  console.log(copy.count)
})

// state 上的修改会触发 copy 上的侦听
state.count++

// 这里只读属性不能被修改
copy.count++ // warning!

5. watchEffect()

watchEffect() 会立即执行传入的函数,并响应式侦听其依赖,并在其依赖变更时重新运行该函数。

  • 基本用法

    const count = ref(0)
    
    // 初次直接执行,打印出 0
    watchEffect(() => console.log(count.value))
    
    setTimeout(() => {
      // 被侦听的数据发生变化,触发函数打印出 1
      count.value++
    }, 1000)
    
  • 停止侦听

    watchEffect() 使用时返回一个函数,当执行这个返回的函数时,就停止侦听。

    const stop = watchEffect(() => {
      /* ... */
    })
    
    // 停止侦听
    stop()
    
  • 更多功能

    请参照 composition-api 文档 —— watchEffect

6. watch()

composition-api 中的 watch 和 Vue2.x 中是一样的,watch 需要侦听数据,并执行它的侦听回调。默认情况下初次渲染不执行。

  • watchwatchEffect 的不同

    1. watch 初次渲染不执行
    2. watch 侦听的更具体
    3. watch 可以访问侦听数据变化前后的值
  • watch 侦听单个数据源

    侦听的数据可以是个 reactive 创建出的响应式数据(拥有返回值的 getter 函数),也可以是个 ref

    // 侦听一个 getter
    const state = reactive({ count: 0 })
    watch(
      () => state.count,
      (count, prevCount) => {
        /* ... */
      }
    )
    
    // 直接侦听一个 ref
    const count = ref(0)
    watch(count, (count, prevCount) => {
      /* ... */
    })
    
  • watch 侦听多个数据源

    在侦听多个数据源时,把参数以数组的形式给 watch

    watch([ref1, ref2], ([newRef1, newRef2],   [prevRef1, prevRef2]) => {
      /* ... */
    })
    
  • watchEffect 同样的更多功能

    请参照 composition-api 文档 —— watch

Composition-Api 依赖工具

下面介绍一下组合式API的依赖方法集:

1. isRef()

isRef() 顾名思义,是用来判断某个值是否为 ref() 创建出来的响应式的值。

当你需要展开某个可能为 ref() 创建的响应式的值的时候,会用到它:

import { isRef } from '@vue/composition-api'

const unwrapper = isRef(foo) ? foo.value : foo

2. toRefs()

toRefs() 可以将 reactive() 创建出来的响应式对象转换成内容为 ref 响应式的值的普通对象

在搞清楚 toRefs() 的用法之前,我们需要先了解一下用 reactive()ref() 创建出来的响应式对象的区别:

  1. reactive() 创建的响应式对象,整个对象是响应式的,而对象里的每一项都是普通的值。当你把它用展开运算符展开后,整个对象的普通值都不是响应式的;
  2. 而用 ref() 创建的响应式的值,本身就是响应式的,并不依赖于其他对象。

所以当你需要展开 reactive() 创建的响应式对象,又不想让他们失去响应式特点的时候,就需要用 toRefs() 将它进行转换:

import { toRefs } from '@vue/composition-api'

setup() {
    // 定义响应式数据对象
    const state = reactive({
        count: 0
    })

    // 定义简单的函数,使count每次+1
    const add = () => {
        state.count++
    }

    // 将setup函数的内容return出去,供外界使用
    return {
        // 将 state 展开导出,同时将其属性都转化为 ref 形式的响应式数据
        ...toRefs(state),
        add
    }
}
<template>
    <div>
        <p>当前的count值为:{{count}}</p>
        <button @click="add">点击+1</button>
    </div>
</template>

其他方法

请参照 composition-api 文档 —— 响应式系统工具集


相关链接

Logo

前往低代码交流专区

更多推荐