Vue 3.0 组合式 API setup 是一种新的方法,用于更好地管理和组织 Vue 应用程序的代码。它允许开发者使用更少的代码来实现更多的功能,并且可以更轻松地将应用程序中的不同部分连接在一起。
Vue 3.0 组合式 API setup 使用一个新的函数,即 setup() 函数,来定义 Vue 应用程序中所有内容。setup() 函数允许开发者将所有内容(包括数据、计算属性、方法、生命周期钩子函数、侦听器和其他内容)都包装在一个函数中。
setup() 函数还允许开发者使用新的依赖注入机制来传递参数。这意味着开发者可以将外部对象传递到 setup() 函数中,并使用这些对象来定义 Vue 组件或应用程序中的行为。
此外,Vue 3.0 组合式 API setup 还允许开发者使用新的 Composition API 来创建复杂的功能。Composition API 是一个新的 JavaScript API,既可以在 Vue 中使用,也可以在 React 中使用。Composition API 允许开发者将复杂功能分割成独立的函数或“片段”,然后将这些片段重新组合成一个大函数。
// example of a setup function in Vue 3.0 const App = { setup() { // define data, computed properties, methods, lifecycle hooks, listeners, etc. here // inject external objects into the function // use composition api to create complex functions } }
本节使用单文件组件代码示例的语法
本指南假定你已经阅读了组合式 API 简介和响应性原理。如果你不熟悉组合式 API,请先阅读这篇文章。
使用 setup
函数时,它将接受两个参数:
props
context
让我们更深入地研究如何使用每个参数。
setup
函数中的第一个参数是 props
。正如在一个标准组件中所期望的那样,setup
函数中的 props
是响应式的,当传入新的 prop 时,它将被更新。
// MyBook.vue
export default {
props: {
title: String
},
setup(props) {
console.log(props.title)
}
}
WARNING
但是,因为 props
是响应式的,你不能使用 ES6 解构,因为它会消除 prop 的响应性。
如果需要解构 prop,可以通过使用 setup
函数中的 toRefs
来安全地完成此操作。
// MyBook.vue
import { toRefs } from "vue"
setup(props) {
const { title } = toRefs(props)
console.log(title.value)
}
传递给 setup
函数的第二个参数是 context
。context
是一个普通的 JavaScript 对象,它暴露三个组件的 property:
// MyBook.vue
export default {
setup(props, context) {
// Attribute (非响应式对象)
console.log(context.attrs)
// 插槽 (非响应式对象)
console.log(context.slots)
// 触发事件 (方法)
console.log(context.emit)
}
}
context
是一个普通的 JavaScript 对象,也就是说,它不是响应式的,这意味着你可以安全地对 context
使用 ES6 解构。
// MyBook.vue
export default {
setup(props, { attrs, slots, emit }) {
...
}
}
attrs
和 slots
是有状态的对象,它们总是会随组件本身的更新而更新。这意味着你应该避免对它们进行解构,并始终以 attrs.x
或 slots.x
的方式引用 property。请注意,与 props
不同,attrs
和 slots
是非响应式的。如果你打算根据 attrs
或 slots
更改应用副作用,那么应该在 onUpdated
生命周期钩子中执行此操作。
执行 setup
时,组件实例尚未被创建。因此,你只能访问以下 property:
props
attrs
slots
emit
换句话说,你将无法访问以下组件选项:
data
computed
methods
如果 setup
返回一个对象,则可以在组件的模板中像传递给 setup
的 props
property 一样访问该对象的 property:
<!-- MyBook.vue -->
<template>
<div>{{ readersNumber }} {{ book.title }}</div>
</template>
<script>
import { ref, reactive } from "vue"
export default {
setup() {
const readersNumber = ref(0)
const book = reactive({ title: "Vue 3 Guide" })
// expose to template
return {
readersNumber,
book
}
}
}
</script>
注意,从 setup
返回的 refs 在模板中访问时是被自动解开的,因此不应在模板中使用 .value
。
setup
还可以返回一个渲染函数,该函数可以直接使用在同一作用域中声明的响应式状态:
// MyBook.vue
import { h, ref, reactive } from "vue"
export default {
setup() {
const readersNumber = ref(0)
const book = reactive({ title: "Vue 3 Guide" })
// Please note that we need to explicitly expose ref value here
return () => h("div", [readersNumber.value, book.title])
}
}
this
在 setup()
内部,this
不会是该活跃实例的引用,因为 setup()
是在解析其它组件选项之前被调用的,所以 setup()
内部的 this
的行为与其它选项中的 this
完全不同。这在和其它选项式 API 一起使用 setup()
时可能会导致混淆。
本指南假定你已经阅读了 Provide / Inject、组合式 API 介绍和响应性基础。如果你不熟悉组合式 API,请先阅读这篇文章。我们也可...
为了学习如何更好地使用 Vue,不需要阅读本页,但是它提供了更多信息,如果你想知道渲染在背后是如何工作的。#虚拟 DOM现在我们...
#介绍当构建可靠的应用时,测试在个人或团队构建新特性、重构代码、修复 bug 等工作中扮演了关键的角色。尽管测试的流派有很多,...
Vue CLI 提供内置的 TypeScript 工具支持。#NPM 包中的官方声明随着应用的增长,静态类型系统可以帮助防止许多潜在的运行时错误...
类 Flux 状态管理的官方实现由于状态零散地分布在许多组件和组件之间的交互中,大型应用复杂度也经常逐渐增长。为了解决这个问题...