Vue3的API——选项式API、组合式API

Vue 的组件可以按两种不同的风格书写：选项式 API 和组合式 API。

对于熟悉Vue2的人来说，选项式api是一个很好的选择，但Vue3提供的组合式api对于代码复用效果更为突出。博主之前是用的React框架，现在由于工作原因换成了Vue，所以个人更倾向于Vue3的组合式api。现在博主将为大家详细介绍这两者的区别以及具体的操作。

选项式 API (Options API)

使用选项式 API，我们可以用包含多个选项的对象来描述组件的逻辑，例如 data、methods 和 mounted。选项所定义的属性都会暴露在函数内部的 this 上，它会指向当前的组件实例。（后续会有专门的文章详细介绍vue的生命周期）

1.  
   <script>
2.  
   export default {
3.  
   // data() 返回的属性将会成为响应式的状态
4.  
   // 并且暴露在 `this` 上
5.  
   data() {
6.  
   return {
7.  
   count: 0
8.  
   }
9.  
   },
10.  
     
11.  
    // methods 是一些用来更改状态与触发更新的函数
12.  
    // 它们可以在模板中作为事件监听器绑定
13.  
    methods: {
14.  
    increment() {
15.  
    this.count
16.  
    }
17.  
    },
18.  
     
19.  
    // 生命周期钩子会在组件生命周期的各个不同阶段被调用
20.  
    // 例如这个函数就会在组件挂载完成后被调用
21.  
    mounted() {
22.  
    console.log('通常项目中初始化在这里调接口')
23.  
    }
24.  
    }
25.  
    </script>
26.  
     
27.  
    <template>
28.  
    <button @click="increment">Count is: {{ count }}</button>
29.  
    </template>

组合式 API (Composition API)

通过组合式 API，我们可以使用导入的 API 函数来描述组件逻辑。在单文件组件中，组合式 API 通常会与 <script setup> 搭配使用。这个 setup 是一个标识，告诉 Vue 需要在编译时进行一些处理，让我们可以更简洁地使用组合式 API。比如，<script setup> 中的导入和顶层变量/函数都能够在模板中直接使用。

组合式 API 是一系列 API 的集合，使我们可以使用函数而不是声明选项的方式书写 Vue 组件。它是一个概括性的术语，涵盖了以下方面的 API：

• 响应式 API：例如 ref() 和 reactive()，使我们可以直接创建响应式状态、计算属性和侦听器。

• 生命周期钩子：例如 onMounted() 和 onUnmounted()，使我们可以在组件各个生命周期阶段添加逻辑。

• 依赖注入：例如 provide() 和 inject()，使我们可以在使用响应式 API 时，利用 Vue 的依赖注入系统。

下面是使用了组合式 API 与 <script setup> 改造后和上面的模板完全一样的组件：

1.  
   <script setup>
2.  
   import { ref, onMounted } from 'vue'
3.  
    
4.  
   // 响应式状态
5.  
   const count = ref(0)
6.  
    
7.  
   // 用来修改状态、触发更新的函数
8.  
   function increment() {
9.  
   count.value
10.  
    }
11.  
     
12.  
    // 生命周期钩子
13.  
    onMounted(() => {
14.  
    console.log(`计数器初始值为 ${count.value}。`)
15.  
    })
16.  
    </script>
17.  
     
18.  
    <template>
19.  
    <button @click="increment">点击了：{{ count }} 次</button>
20.  
    </template>

虽然这套 API 的风格是基于函数的组合，但组合式 API 并不是函数式编程。组合式 API 是以 Vue 中数据可变的、细粒度的响应性系统为基础的，而函数式编程通常强调数据不可变。

哪一个更好？该如何选择？两者有什么区别？

大家可以自己选择适合自己的编程风格，组合式api的目的是增强，并不是取代选项式api，vue3对两种api都是支持的。两种 API 风格都能够覆盖大部分的应用场景。它们只是同一个底层系统所提供的两套不同的接口。实际上，选项式 API 是在组合式 API 的基础上实现的！关于 Vue 的基础概念和知识在它们之间都是通用的。

选项式 API 以“组件实例”的概念为中心 (即上述例子中的 this)，对于有面向对象语言背景的用户来说，这通常与基于类的心智模型更为一致。同时，它将响应性相关的细节抽象出来，并强制按照选项来组织代码，从而对初学者而言更为友好。

组合式 API 的核心思想是直接在函数作用域内定义响应式状态变量，并将从多个函数中得到的状态组合起来处理复杂问题。这种形式更加自由，也需要你对 Vue 的响应式系统有更深的理解才能高效使用。相应的，它的灵活性也使得组织和重用逻辑的模式变得更加强大。

如上方图所示，这是vue3官方提供的对选项式api进行重构后，标出相同逻辑功能代码区块，我们可以看到，左边的选项式api处理相同逻辑关注点的代码被强制拆分在了不同的选项中，位于文件的不同部分。在一个几百行的大组件中，要读懂代码中的一个逻辑关注点，需要在文件中反复上下滚动，这并不理想。另外，如果我们想要将一个逻辑关注点抽取重构到一个可复用的工具函数中，需要从文件的多个不同部分找到所需的正确片段。我们再看看右边的组合式api，它与同一个逻辑关注点相关的代码被归为了一组：我们无需再为了一个逻辑关注点在不同的选项块间来回滚动切换。此外，我们现在可以很轻松地将这一组代码移动到一个外部文件中，不再需要为了抽象而重新组织代码，大大降低了重构成本，这在长期维护的大型项目中非常关键。

下方是博主画的可简单供大家理解，与vue官方提供的图所表示的含义是一样的

如果你是使用 Vue 的新手，这里是博主的大致建议：

• 在学习的过程中，推荐采用更易于自己理解的风格。再强调一下，大部分的核心概念在这两种风格之间都是通用的。熟悉了一种风格以后，你也能够很快地理解另一种风格。

• 在生产项目中：

  • 当你不需要使用构建工具，或者打算主要在低复杂度的场景中使用 Vue，例如渐进增强的应用场景，推荐采用选项式 API。

  • 当你打算用 Vue 构建完整的单页应用，推荐采用组合式 API 单文件组件。

在学习阶段，不必只固守一种风格。在接下来的文章中博主会提供一系列两种风格的代码供参考，但是由于博主是从react转的vue，所以组合式api的代码风格会更多，如果有任何疑问可以放在评论区噢~博主看到就会立马回复哒！

这篇好文章是转载于：学新通技术网