前言

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

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

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

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

---

setup() 函数

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

在Vue3中，定义 methods、watch、computed、data数据 等都放在了 setup() 函数中

1. 执行时机

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

2. 接收props数据

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

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

3. context上下文对象

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

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

注意：在 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 需要侦听数据，并执行它的侦听回调。默认情况下初次渲染不执行。

• watch 与 watchEffect 的不同

  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 文档 —— 响应式系统工具集

---

相关链接

• Vue3 的新特性