Vue 的组件可以按两种不同的风格书写:选项式 API 和组合式 API。
(一)、选项式 API (Options API)
使用选项式 API,我们可以用包含多个选项的对象来描述组件的逻辑,例如 data
、methods
和 mounted
。选项所定义的属性都会暴露在函数内部的 this
上,它会指向当前的组件实例。
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(`The initial count is ${this.count}.`) 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
attribute 是一个标识,告诉 Vue 需要在编译时进行一些处理,让我们可以更简洁地使用组合式 API。比如,<script setup>
中的导入和顶层变量/函数都能够在模板中直接使用。
下面是使用了组合式 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(`The initial count is ${count.value}.`) 15 }) 16 </script> 17 18 <template> 19 <button @click="increment">Count is: {{ count }}</button> 20 </template>
(三)该选哪一个?
两种 API 风格都能够覆盖大部分的应用场景。它们只是同一个底层系统所提供的两套不同的接口。实际上,选项式 API 是在组合式 API 的基础上实现的!关于 Vue 的基础概念和知识在它们之间都是通用的。
选项式 API 以“组件实例”的概念为中心 (即上述例子中的 this
),对于有面向对象语言背景的用户来说,这通常与基于类的心智模型更为一致。同时,它将响应性相关的细节抽象出来,并强制按照选项来组织代码,从而对初学者而言更为友好。
组合式 API 的核心思想是直接在函数作用域内定义响应式状态变量,并将从多个函数中得到的状态组合起来处理复杂问题。这种形式更加自由,也需要你对 Vue 的响应式系统有更深的理解才能高效使用。相应的,它的灵活性也使得组织和重用逻辑的模式变得更加强大。
(四)在生产项目中
-
当你不需要使用构建工具,或者打算主要在低复杂度的场景中使用 Vue,例如渐进增强的应用场景,推荐采用选项式 API。
-
当你打算用 Vue 构建完整的单页应用,推荐采用组合式 API + 单文件组件。