当Vue2遇到Composition API,它们之间到底能擦出怎样的火花?

简介: Composition API是什么?也称为组合式 API。如果你第一次听到这个词,请认真读完这篇文章。

前言


Composition API是什么?也称为组合式 API。如果你第一次听到这个词,请认真读完这篇文章。


官网有这样一段解释:


通过创建 Vue 组件,我们可以将界面中重复的部分连同其功能一起提取为可重用的代码段。仅此一项就可以使我们的应用在可维护性和灵活性方面走得相当远。然而,我们的经验已经证明,光靠这一点可能并不够,尤其是当你的应用变得非常大的时候——想想几百个组件。处理这样的大型应用时,共享和重用代码变得尤为重要。


我们之前创建组件更多地是使用OptionAPI(data、computed、methods、watch) ,但是,当我们的组件开始变得更大时,逻辑关注点的列表也会增长。尤其对于那些一开始没有编写这些组件的人来说,这会导致组件难以阅读和理解。


如果能够将同一个逻辑关注点相关代码收集在一起会更好。而这正是组合式 API 使我们能够做到的。


提到组合式API,我们可能更多地想到在Vue3中使用。但是目前国内大部分Vue项目都还是Vue2项目,如果迁移到Vue3,可能还需要花费一定的精力。你在此处可能会有一个疑问:Vue2项目可以迁移到Vue3吗?答案是可以的。如果你想知道怎么操作,可以点击下方链接:


https://github.com/vuejs/vue-next/tree/master/packages/vue-compat


但是,迁移之前需要你主要几点问题,官方这样解释:


虽然我们努力使迁移构建尽可能模仿 Vue 2 的行为,但仍有一些限制可能会阻止您的应用程序有资格升级:

  • 依赖 Vue 2 内部 API 或未记录行为的依赖项。最常见的情况是在 上使用私有属性VNodes。如果您的项目依赖于Vuetify、Quasar或ElementUI等组件库,最好等待它们的 Vue 3 兼容版本。
  • Internet Explorer 11 支持:Vue 3 已正式放弃支持 IE11 的计划。如果您仍然需要支持 IE11 或更低版本,则必须继续使用 Vue 2。
  • 服务器端渲染:迁移构建可用于 SSR,但迁移自定义 SSR 设置要复杂得多。总的想法是替换vue-server-renderer用@vue/server-renderer。Vue 3 不再提供捆绑渲染器,建议将 Vue 3 SSR 与Vite一起使用。如果您正在使用Nuxt.js,那么等待 Nuxt 3 可能会更好。


可以看到,从Vue2迁移到Vue3肯定需要一定的成本,那么有什么办法让我在Vue2也可以用到Composition API。其实,现在已经出了解决方案。你可以上网搜下这样一个库@vue/composition-api,这个库是专门为Vue使用Composition-api而生,目前是发布候选版。


安装与使用


NPM


npm install @vue/composition-api
# or
yarn add @vue/composition-api


SFC


必须通过vue.use()@vue/composition-api作为插件安装,然后才能使用composition-api编写组件。所以,请这样。一般在你的项目文件夹中的main.js编辑如下:


import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)


然后,在组件中这样使用。


import {reactive, toRefs} from '@vue/composition-api'
export default {
  name: 'HelloWorld',
  props: {
    msg: String
  },
  setup(props){
    const obj = reactive({
      name:'maomin',
      age:18
    });
    console.log(props.msg);
    return {
      ...toRefs(obj)
    }
  }
}


当你迁移到Vue 3时,只要将@vue/compositionapi替换为vue,你的代码就可以正常工作了。


另外,你需要注意的是,如果你在使用TypeScript,为了正确推断Vue组件选项中的类型,需要使用defineComponent定义组件。


import { defineComponent } from '@vue/composition-api'
export default defineComponent({
  // type inference enabled
})


CDN


如果你想使用CDN,同样也有办法。在vue之后包含@vue/compositionapi,它将自动安装自己。


<script src="https://cdn.jsdelivr.net/npm/vue@2.6"></script>
<script src="https://cdn.jsdelivr.net/npm/@vue/composition-api@1.0.0-rc.13"></script>


这时,@vue/composition-api将暴露于全局变量window.VueCompositionAPI


<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <div id="app">
        <p>{{num}}</p>
        <div>{{obj.page}}</div>
    </div>
    <script src="https://cdn.jsdelivr.net/npm/vue@2.6"></script>
    <script src="https://cdn.jsdelivr.net/npm/@vue/composition-api@1.0.0-rc.13"></script>
    <script>
        const { ref, reactive } = VueCompositionAPI
        new Vue({
            el: '#app',
            setup() {
                const num = ref(0);
                const obj = reactive({
                    page: 1,
                    pageSize: 10
                })
                return {
                    num,
                    obj
                }
            }
        })
    </script>
</body>
</html>


结语


@vue/composition-api支持所有现代浏览器和IE11+。你可以在Vue2项目使用它,然后在合适的时机无缝衔接到Vue3项目。


下面是@vue/composition-apigithub网址:


https://github.com/vuejs/composition-api


另外,关于CompositionApi的用法还有很多,可以查看下方的官方文档:


https://v3.cn.vuejs.org/guide/composition-api-introduction.html



相关文章
|
2月前
|
缓存 JavaScript 算法
活用 Composition API 核心函数,打造卓越应用(下)
活用 Composition API 核心函数,打造卓越应用(下)
|
2月前
|
存储 JavaScript API
活用 Composition API 核心函数,打造卓越应用(上)
活用 Composition API 核心函数,打造卓越应用(上)
|
2月前
|
JavaScript 前端开发 API
深入浅出:Vue 3 Composition API 的魅力与实践
【2月更文挑战第13天】 本文将探索 Vue 3 的核心特性之一——Composition API。通过对比 Options API,本文旨在揭示 Composition API 如何提高代码的组织性和可复用性,并通过实际案例展示其在现代前端开发中的应用。不同于传统的技术文章摘要,我们将通过一个具体的开发场景,引领读者步入 Composition API 的世界,展现它如何优雅地解决复杂组件逻辑的管理问题,从而激发读者探索和运用 Vue 3 新特性的热情。
25 1
|
2月前
|
JavaScript API
vue 3.0 所采用的 Composition Api 和 vue 2.0 使用的 Option Api 区别
vue 3.0 所采用的 Composition Api 和 vue 2.0 使用的 Option Api 区别
37 0
|
19天前
|
JavaScript 前端开发 API
组合API:掌握Vue的组合式API(Composition API)
【4月更文挑战第24天】Vue.js的组合式API是Vue 3中的新特性,旨在提供更灵活的组件逻辑组织方式。它允许开发者像React Hooks一样定义和复用逻辑单元——组合函数。通过组合函数,可以跨组件共享和管理状态,提升代码复用和维护性。本文介绍了如何开始使用组合式API,包括安装Vue CLI、引入API、使用组合函数以及组织和复用逻辑。掌握组合式API能增强开发复杂应用的能力,改善代码结构和可读性。
|
1月前
|
JavaScript API UED
Vue3.0新特性解析与实战:Composition API、Teleport与Suspense
【4月更文挑战第6天】Vue3.0引入了颠覆性的Composition API,通过函数式方法提升代码可读性和复用性,例如`setup()`、`ref`等,便于逻辑模块化。实战中,自定义的`useUser`函数可在多个组件中共享用户信息逻辑。另外,Teleport允许组件渲染到DOM特定位置,解决模态框等场景的上下文问题。再者,Suspense提供异步组件加载的延迟渲染,使用fallback内容改善用户体验。这些新特性显著优化了开发和性能,适应现代Web需求。
23 0
|
1月前
|
JavaScript API
Composition Api 与 Options Api 有什么区别?
Composition Api 与 Options Api 有什么区别?
16 0
|
2天前
|
安全 API 开发者
智能体-Agent能力升级!新增Assistant API & Tools API服务接口
ModelScope-Agent是一个交互式创作空间,它支持LLM(Language Model)的扩展能力,例如工具调用(function calling)和知识检索(knowledge retrieval)。它已经对相关接口进行了开源,以提供更原子化的应用LLM能力。用户可以通过Modelscope-Agent上的不同代理(agent),结合自定义的LLM配置和消息,调用这些能力。
|
6天前
|
JSON 搜索推荐 数据挖掘
电商数据分析的利器:电商关键词搜索API接口(标题丨图片丨价格丨链接)
淘宝关键词搜索接口为电商领域的数据分析提供了丰富的数据源。通过有效利用这一接口,企业和研究人员可以更深入地洞察市场动态,优化营销策略,并提升用户体验。随着电商平台技术的不断进步,未来的API将更加智能和个性化,为电商行业带来更多的可能性。
|
14天前
|
存储 缓存 运维
DataWorks操作报错合集之DataWorks根据api,调用查询文件列表接口报错如何解决
DataWorks是阿里云提供的一站式大数据开发与治理平台,支持数据集成、数据开发、数据服务、数据质量管理、数据安全管理等全流程数据处理。在使用DataWorks过程中,可能会遇到各种操作报错。以下是一些常见的报错情况及其可能的原因和解决方法。
23 1