超详细!图文讲解Vue3的组合式API!

广告:宝塔服务器面板,一键全能部署及管理,送你10850元礼包,点我领取~~~

超详细!图文讲解Vue3的组合式API!

组合式API
组合式api(Composition API)算是vue3对我们开发者来说非常有价值的一个api更新,我们先不关注具体语法,先对它有一个大的感知
1. composition vs optionsoptions API开发出来的vue应用如左图所示,它的特点是理解容易,因为各个选项都有固定的书写位置,比如响应式数据就写到data选择中,操作方法就写到methods配置项中等,应用大了之后,相信大家都遇到过来回上下找代码的困境composition API开发的vue应用如右图所示,它的特点是特定功能相关的所有东西都放到一起维护,比如功能A相关的响应式数据,操作数据的方法等放到一起,这样不管应用多大,都可以快读定位到某个功能的所有相关代码,维护方便,设置如果功能复杂,代码量大,我们还可以进行逻辑拆分处理【推荐:vue视频教程】特别注意:

选项式api和组合式api俩种风格是并存的关系 并不是非此即彼

需要大量的逻辑组合的场景,可以使用compition API进行增强

2. 案例对比

上面我们通过图示简单了解了一下vue3带来的全新的api形式,下面我们通过一个具体的小案例更加深入的体会一下俩种api下的开发模式对比,我们先暂时忽略语法细节,只关注代码编写形式

2.1 理解需求

俩个独立的功能:

通过点击按钮来控制p的显示和隐藏

通过点击按钮控制p内字体颜色的变化

2.2 vue2.x option Api版本
<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDiv">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeYellow">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>export default {  name: 'App',  data() {    return {      showDiv: true, // 功能一数据      fontColor: '' // 功能二数据    }  },  methods: {    // 功能一方法    show() {      this.showDiv = true    },    hide() {      this.showDiv = false    },    // 功能二方法    changeRed() {      this.fontColor = 'red'    },    changeYellow() {      this.fontColor = 'blue'    }  }}</script>
登录后复制2.3 vue3.0 composition api版本
<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>
登录后复制2.4 composition api版本优化

在这里可能会有疑惑,那我们现在是把功能相关的所有数据和行为放到一起维护了,如果应用很大功能很多的情况下,setup函数不会变得很大吗?岂不是又会变得比较难维护,接下来我们就来拆解一下庞大的setup函数

<script>import { ref } from 'vue'function useShow() {  const showpFlag = ref(true)  function show() {    showpFlag.value = true  }  function hide() {    showpFlag.value = false  }  return { showpFlag, show, hide }}function useColor() {  const fontColor = ref('')  function changeRed() {    fontColor.value = 'red'  }  function changeBlue() {    fontColor.value = 'blue'  }  return { fontColor, changeRed, changeBlue }}export default {  name: 'App',  setup() {    // 功能一    const { showpFlag, show, hide } = useShow()    // 功能二    const { fontColor, changeRed, changeBlue } = useColor()    return { showpFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>
登录后复制

以上,我们通过定义功能函数,把俩个功能相关的代码各自抽离到一个独立的小函数中,然后通过在setUp函数中再把俩个小功能函数组合起来,这样一来,我们既可以把setup函数变得清爽,又可以方便维护快速定位功能位置

到此我们没有关注api细节,只是体会组合式api给到我们的好处,接下来我们就要深入到api细节,看看全新的api都该如何使用 ↓

3. setup入口函数setup 函数是一个新的组件选项,作为组件中组合式API 的起点(入口)setup 中不能使用 this, this 指向 undefinedsetup函数只会在组件初始化的时候执行一次setup函数在beforeCreate生命周期钩子执行之前执行
export default {  setup () {    console.log('setup执行了')    console.log(this)  },  beforeCreate() {    console.log('beforeCreate执行了')    console.log(this)  }}
登录后复制4. 响应式系统API4.1 reactive 函数
作用:reactive是一个函数,接收一个普通的对象传入,把对象数据转化为响应式对象并返回

使用步骤

从vue框架中导入reactive函数

在setup函数中调用reactive函数并将对象数据传入

在setup函数中把reactive函数调用完毕之后的返回值以对象的形式返回出去

代码落地

<template>  <div>{{ state.name }}</div>  <div>{{ state.age }}</div>  <button @click="state.name = 'pink'">改值</button></template><script>import { reactive } from 'vue'export default {  setup () {    const state = reactive({      name: 'cp',      age: 18    })    return {      state    }  }}</script>
登录后复制4.2 ref 函数
作用:ref是一个函数,接受一个简单类型或者复杂类型的传入并返回一个响应式且可变的 ref 对象

使用步骤

从vue框架中导出ref函数

在setup函数中调用ref函数并传入数据(简单类型或者复杂类型)

在setup函数中把ref函数调用完毕的返回值以对象的形式返回出去

注意:在setup函数中使用ref结果,需要通过.value 访问,模板中使用不需要加.value

<template>  <div>{{ money }}</div>  <button @click="changeMondy">改值</button></template><script>import { ref } from 'vue'export default {  setup() {    let money = ref(100)    console.log(money.value)    return {      money    }  }}</script>
登录后复制

总结说明:

ref 函数可以接收一个简单类型的值,返回一个可改变的 ref 响应式对象,从而弥补reactive函数不支持简单类型的问题

reactive和ref函数都可以提供响应式数据的转换,具体什么时候需要使用哪个API社区还没有最佳实践,大家暂时可以使用自己熟练的API进行转换

推荐一种写法:只有我们明确知道要转换的对象内部的字段名称我们才使用reactive,否则就一律使用ref,从而降低在语法选择上的心智负担

4.3 toRefs 函数
场景: 经过reactive函数处理之后返回的对象,如果给这个对象解构或者展开,会让数据丢失响应式的能力,为了解决这个问题需要引入toRefs函数,使用 toRefs函数 可以保证该对象展开的每个属性都是响应式的
4.3.1 问题复现

还是之前的案例,如果我们想在模板中省略到state,直接书写name和age,你可能会想到,那我在return出去的时候把state中的属性解构出来不就好了

修改前

<template>  <div>{{ state.name }}</div>  <div>{{ state.age }}</div>  <button @click="state.name = 'pink'">改值</button></template><script>import { reactive } from 'vue'export default {  setup() {    const state = reactive({      name: 'cp',      age: 18    })    return {      state    }  }}</script>
登录后复制

解构修改后

<template>  <div>{{ name }}</div>  <div>{{ age }}</div>  <button @click="name = 'pink'">改值</button></template><script>import { reactive } from 'vue'export default {  setup() {    const state = reactive({      name: 'cp',      age: 18    })    return {      ...state    }  }}</script>
登录后复制点击改值按钮,发现视图已经不发生变化了,这就是我们所说的,如果解构reactive的返回值,将破坏调用响应式特性,就需要我们使用toRefs方法进行处理了4.3.2 toRefs包裹处理
<template>  <div>{{ name }}</div>  <div>{{ age }}</div>  <button @click="name = 'pink'">改值</button></template><script>import { reactive,toRefs } from 'vue'export default {  setup() {    const state = reactive({      name: 'cp',      age: 18    })    return {      ...toRefs(state)    }  }}</script>
登录后复制4.4 computed在setup函数中使用计算属性函数

作用:根据现有响应式数据经过一定的计算得到全新的数据

使用步骤

从vue框架中导入computed 函数

在setup函数中执行computed函数,并传入一个函数,在函数中定义计算公式

把computed函数调用完的执行结果放到setup的return值对象中

<template>  {{ list }}  {{ filterList }}  <button @click="changeList">change list</button></template><script>import { computed, ref } from 'vue'export default {  setup() {    const list = ref([1, 2, 3, 4, 5])    // 输入大于3的数字    const filterList = computed(() => {      return list.value.filter(item => item > 3)    })    // 修改list的函数    function changeList() {      list.value.push(6, 7, 8)    }    return {      list,      filterList,      changeList    }  }}</script>
登录后复制4.5 watch 侦听器在setup函数中侦听器的使用

作用:基于响应式数据的变化执行回调逻辑,和vue2中的watch的功能完全一致

普通监听

立即执行

深度监听

使用步骤

从vue框架中导入watch函数

在setup函数中执行watch函数开启对响应式数据的监听

watch函数接收三个常规参数

第一个参数为函数,返回你要监听变化的响应式数据第二个参数为响应式数据变化之后要执行的回调函数第三个参数为一个对象,在里面配置是否开启立刻执行或者深度监听4.5.1 普通监听
<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>0
登录后复制4.5.2 开启立刻执行

watch的效果默认状态下,只有监听的数据发生变化才会执行回调,如果你需要在一上来的时候就立刻执行一次,需要配置一下immediate属性

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>1
登录后复制4.5.3 开启深度监听

当我们监听的数据是一个对象的时候,默认状态下,对象内部的属性发生变化是不会引起回调函数执行的,如果想让对象下面所有属性都能得到监听,需要开启deep配置

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>2
登录后复制4.5.4 更好的做法

使用watch的时候,尽量详细的表明你到底要监听哪个属性,避免使用deep引起的性能问题,比如我仅仅只是想在state对象的age属性变化的时候执行回调,可以这么写

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>3
登录后复制5. 生命周期函数

使用步骤

先从vue中导入以on打头的生命周期钩子函数

在setup函数中调用生命周期函数并传入回调函数

生命周期钩子函数可以调用多次

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>4
登录后复制选项式API组合式APIbeforeCreate不需要(直接写到setup函数中)created不需要(直接写到setup函数中)beforeMountonBeforeMountmountedonMountedbeforeUpdateonBeforeUpdateupdatedonUpdatedbeforeDestroyedonBeforeUnmountdestroyedonUnmounted6. 父子通信

在vue3的组合式API中,父传子的基础套路完全一样,基础思想依旧为:父传子是通过prop进行传入,子传父通过调用自定义事件完成

实现步骤

setup函数提供俩个参数,第一个参数为props,第二个参数为一个对象context

props为一个对象,内部包含了父组件传递过来的所有prop数据,context对象包含了attrs,slots, emit属性,其中的emit可以触发自定义事件的执行从而完成子传父

代码落地app.vue

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>5
登录后复制

components/son.vue

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>6
登录后复制7. provide 和 inject

通常我们使用props进行父子之间的数据传递,但是如果组件嵌套层级较深,一层一层往下传递将会变的非常繁琐,有没有一种手段可以把这个过程简化一下呢,有的,就是我们马上要学习的provide 和 inject,它们配合起来可以方便的完成跨层传递数据

7.1 基础使用在setup函数中使用provide和inject的基础用法

来个需求: 爷组件中有一份数据 传递给孙组件直接使用

实现步骤:

顶层组件在setup方法中使用provide函数提供数据

任何底层组件在setup方法中使用inject函数获取数据

代码落地爷爷组件 - app.vue

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>7
登录后复制

孙组件 - components/Son.vue

<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>8
登录后复制

事实上,只要是后代组件,都可以方便的获取顶层组件提供的数据

7.2 传递响应式数据

provide默认情况下传递的数据不是响应式的,也就是如果对provide提供的数据进行修改,并不能响应式的影响到底层组件使用数据的地方,如果想要传递响应数据也非常简单,只需要将传递的数据使用ref或者reactive生成即可

通过provide/inject传递响应式数据app.vue
<template>  <div>    <!-- 功能一模板 -->    <button @click="show">显示</button>    <button @click="hide">隐藏</button>    <div v-if="showDivFlag">一个被控制显隐的div</div>  </div>  <div>    <!-- 功能二模板 -->    <button @click="changeRed">红色</button>    <button @click="changeBlue">蓝色</button>    <div :style="`color:${fontColor}`">一个被控制字体颜色的的div</div>  </div></template><script>import { ref } from 'vue'export default {  name: 'App',  setup() {    // 功能一    const showDivFlag = ref(true)    function show() {      showDivFlag.value = true    }    function hide() {      showDivFlag.value = false    }    // 功能二    const fontColor = ref('')    function changeRed() {      fontColor.value = 'red'    }    function changeBlue() {      fontColor.value = 'blue'    }    return { showDivFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>9
登录后复制8. 模板中 ref 的使用

在模板中使用ref,我们都很清楚,它一般有三种使用场景

ref + 普通dom标签 获取真实dom对象

ref + 组件标签 获取组件实例对象

ref + v-for 获取由dom对象(实例对象)组成的数组 (不经常使用)

在setup函数中使用ref获取真实dom获取组件实例的方法

实现步骤

使用ref函数传入null创建 ref对象 => const hRef = ref(null)

模板中通过定义ref属性等于1中创建的ref对象名称建立关联 => <h1 ref="hRef"></h1>

使用 =>hRef.value

代码落地components/RefComponent.vue

<script>import { ref } from 'vue'function useShow() {  const showpFlag = ref(true)  function show() {    showpFlag.value = true  }  function hide() {    showpFlag.value = false  }  return { showpFlag, show, hide }}function useColor() {  const fontColor = ref('')  function changeRed() {    fontColor.value = 'red'  }  function changeBlue() {    fontColor.value = 'blue'  }  return { fontColor, changeRed, changeBlue }}export default {  name: 'App',  setup() {    // 功能一    const { showpFlag, show, hide } = useShow()    // 功能二    const { fontColor, changeRed, changeBlue } = useColor()    return { showpFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>0
登录后复制

app.vue

<script>import { ref } from 'vue'function useShow() {  const showpFlag = ref(true)  function show() {    showpFlag.value = true  }  function hide() {    showpFlag.value = false  }  return { showpFlag, show, hide }}function useColor() {  const fontColor = ref('')  function changeRed() {    fontColor.value = 'red'  }  function changeBlue() {    fontColor.value = 'blue'  }  return { fontColor, changeRed, changeBlue }}export default {  name: 'App',  setup() {    // 功能一    const { showpFlag, show, hide } = useShow()    // 功能二    const { fontColor, changeRed, changeBlue } = useColor()    return { showpFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>1
登录后复制9. 来个案例吧 - Todos

核心功能

渲染列表数据 v-for

点击删除当前列表 splice + index

回车添加新项目 @keyup.enter=“addTodo” list.unshift

选择状态切换 v-model

多选和取消多选 计算属性的set和get

未完成任务数量统计 computed

<script>import { ref } from 'vue'function useShow() {  const showpFlag = ref(true)  function show() {    showpFlag.value = true  }  function hide() {    showpFlag.value = false  }  return { showpFlag, show, hide }}function useColor() {  const fontColor = ref('')  function changeRed() {    fontColor.value = 'red'  }  function changeBlue() {    fontColor.value = 'blue'  }  return { fontColor, changeRed, changeBlue }}export default {  name: 'App',  setup() {    // 功能一    const { showpFlag, show, hide } = useShow()    // 功能二    const { fontColor, changeRed, changeBlue } = useColor()    return { showpFlag, show, hide, fontColor, changeRed, changeBlue }  }}</script>2
登录后复制

以上就是超详细!图文讲解Vue3的组合式API!的详细内容,更多请关注9543建站博客其它相关文章!

9543建站博客
一个专注于网站开发、微信开发的技术类纯净博客。
作者头像
admin创始人

肥猫,知名SEO博客站长,14年SEO经验。

上一篇:如何写一份uniapp代码管理
下一篇:用nodejs搭建聊天室

发表评论

关闭广告
关闭广告