首页>>前端>>Vue->一个例子讲清Vue Composition API

一个例子讲清Vue Composition API

时间:2023-11-30 本站 点击:1

一、Composition API概述

当我们编写Vue组件时候,组件中可能包含一系列的功能,例如一个代码仓库管理的应用,用户的仓库列表可以看做是一个组件,这个组件还包含筛选、搜索的功能。

所谓的功能我们可以理解为MVC中的Model和Controller。从视图角度,组件是最基本的代码复用单元,但是从逻辑上,功能模块是最基本的代码复用单元。

每个组件中可能包含多个功能(也称为关注点),而多个功能的代码会分散在Vue组件的各个部分:data/props/watch/computed/dom event callback/lifescycle。

这会带来两个问题:

可读性和可维护性差,比如我们想要阅读某个功能的逻辑,需要翻遍整个组件,到处查看相应的逻辑;当需要改动某个功能时候,需要在很多地方进行改动。

Vue未提供功能模块级别的代码复用支持,只提供组件级别的复用的话,在大型项目中是不够的。

为了解决上面两个问题,Vue需要提供功能模块级别的代码组织方式,即需要将同一个功能模块的代码写在同一片区域,而不是分散到组件的各个API中,另外还需要支持功能模块的封装,以便我们可以提取功能模块的代码进行复用。

如何实现上述两个能力呢?我们看看一个功能模块都包含哪些内容。

数据

数据的计算

数据的更新

数据监听

其中数据部分的代码写在Vue组件中的data、props中

数据计算部分的代码写在Vue组件中的computed和处理数据的方法中

数据更新部分代码写在生命周期钩子方法和交互事件中

数据监听代码写在watch中

因此我们希望Vue能提供一个API,让我们把一个功能模块(即关注点)的这些代码(包括data/props/computed/watch/dom event callback/lifecycle)都写在一起。并且能将其提取。

组合式API就提供了这样的能力。

总之,组合式API是在Vue3中新增加的API,它有两点优势:

让功能模块代码(关注点)聚合在一起,使可读性和可维护性更高。

提供了一种功能模块级别的复用代码的方式。

二、Composition API使用

开发者如何使用组合式API呢?简单地说,需要在Vue组件里实现setup方法,并在方法中返回一些方法和属性,返回的所有内容都将暴露给组件的其余部分 (计算属性、方法、生命周期钩子等等) 以及组件的模板。

首先看一个简单的例子,下面是一个单文件组件

<template>    <div id="app">        <span class="counter">            {{counter}}            <button @click="increase">+1</button>        </span>        <div class="msg-panel">            <span v-if="showMsg">                hello, world            </span>            <button @click="toggleShowCondition">{{showWhenOdd ? '奇数展示' : '偶数展示'}}</button>        </div>    </div></template><script>export default {    data() {        return {            counter: 0,            showWhenOdd: true        };    },    computed: {        showMsg() {            return this.counter % 2 === 0                ? this.showWhenOdd                : !this.showWhenOdd;        }    },    mounted() {        this.counter = Math.floor(Math.random() * 9) + 1;    },    methods: {        increase() {            this.counter++;        },        toggleShowCondition() {            this.showWhenOdd = !this.showWhenOdd;        }    }};</script><style scoped>#app {    text-align: center;    margin-top: 60px;}.counter {    width: 100px;    height: 100px;    border: 1px solid;    padding: 10px;}.msg-panel {    width: 100px;    height: 100px;    margin: 50px auto;    border: 1px solid;    padding: 10px;}</style>

效果如下:

这个组件有两个功能

展示一个计数器,计数器初始化计数是1-10之间的一个随机数,每次点击"+1"按钮会让计数加1,计数实时展示在界面上

信息展示,仅当计数为偶数时候,才会展示"hello, world"信息。也可以通过点击"奇数展示"按钮来控制 仅当计数为奇数时候展示信息。

理解了上面的功能的实现之后我们再来看下使用组合式API如何实现相同的功能。

<template>    <div id="app">        <span class="counter">            {{counter}}            <button @click="increase">+1</button>        </span>        <div class="msg-panel">            <span v-if="showMsg">                hello, world            </span>            <button @click="toggleShowCondition">{{showWhenOdd ? '奇数展示' : '偶数展示'}}</button>        </div>    </div></template><script>import {ref, onMounted, computed} from 'vue';export default {    setup() {        // counter逻辑        const counter = ref(0);        const increase = () => {            counter.value++;        };        onMounted(() => {            counter.value = Math.floor(Math.random() * 9) + 1;        });        // 提示信息逻辑        const showWhenOdd = ref(true);        const showMsg = computed(() => {            return counter.value % 2 === 0                ? showWhenOdd.value                : !showWhenOdd.value;        });        const toggleShowCondition = () => {            showWhenOdd.value = !showWhenOdd.value;        };        return {            counter,            increase,            showWhenOdd,            showMsg,            toggleShowCondition        };    }};</script><style scoped>#app {    text-align: center;    margin-top: 60px;}.counter {    width: 100px;    height: 100px;    border: 1px solid;    padding: 10px;}.msg-panel {    width: 100px;    height: 100px;    margin: 50px auto;    border: 1px solid;    padding: 10px;}</style>

上面使用了组合式API的示例实现了相同的功能,注意:

之前的各种Vue组件的属性 data/methods/computed/mounted等被setup方法代替,setup方法返回的值里面包括模板需要用到的数据和方法。

之前组件的data里面的数据(counter、showWhenOdd)用ref(<初始值>)代替,数据使用时候,需要通过.value取值。

之前写在methods中的方法都在setup方法里面实现并返回。

之前写在computed中的计算属性通过vue中的computed实现,computed接受一个函数,函数返回计算结果。

之前生命周期钩子mounted被setup中通过onMounted包裹的函数来代替。

对比两段代码我们可以看出,使用setup API的实现明显可以将两段功能逻辑(counter和展示提示信息)各自聚合在一起

这样就实现了我们之前提到的“让功能模块代码(关注点)聚合在一起,使可读性和可维护性更高”的效果,如果我们还希望实现“提供了一种功能模块级别的复用代码的方式”,我们可以这样组织代码:

<template>    <div id="app">        <span class="counter">            {{counter}}            <button @click="increase">+1</button>        </span>        <div class="msg-panel">            <span v-if="showMsg">                hello, world            </span>            <button @click="toggleShowCondition">{{showWhenOdd ? '奇数展示' : '偶数展示'}}</button>        </div>    </div></template><script>import {ref, onMounted, computed} from 'vue';const useCounter = () => {    // counter逻辑    const counter = ref(0);    const increase = () => {        counter.value++;    };    onMounted(() => {        counter.value = Math.floor(Math.random() * 9) + 1;    });    return {        counter,        increase    };};const useMsg = counter => {    const showWhenOdd = ref(true);    const showMsg = computed(() => {        return counter.value % 2 === 0            ? showWhenOdd.value            : !showWhenOdd.value;    });    const toggleShowCondition = () => {        showWhenOdd.value = !showWhenOdd.value;    };    return {        showWhenOdd,        showMsg,        toggleShowCondition    };};export default {    setup() {        const {counter, increase} = useCounter();        const {showWhenOdd, showMsg, toggleShowCondition} = useMsg(counter);        return {            counter,            increase,            showWhenOdd,            showMsg,            toggleShowCondition        };    }};</script><style scoped>#app {    text-align: center;    margin-top: 60px;}.counter {    width: 100px;    height: 100px;    border: 1px solid;    padding: 10px;}.msg-panel {    width: 100px;    height: 100px;    margin: 50px auto;    border: 1px solid;    padding: 10px;}</style>

通过上面示例可以看到,我们将不同的功能模块封装在函数中,并将关键数据和方法返回,然后在Vue组件的setup方法中引用并返回,就可以在模板中使用了。

除了上述的几个关键API:setup/ref/computed/onMounted,还有toRef用于解构props中的属性,watch用于监听数据,代替Vue组件中的watch属性。可以在官方文档查看用法。

原文:https://juejin.cn/post/7094774317644251150


本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:/Vue/3736.html