Setup
使用 setup
函数时,它将接受两个参数:
props
context
让我们更深入地研究如何使用每个参数。
setup
函数中的第一个参数是 props
。正如在一个标准组件中所期望的那样,setup
函数中的 props
是响应式的,当传入新的 prop 时,它将被更新。
但是,因为 props
是响应式的,你不能使用 ES6 解构,因为它会消除 prop 的响应性。
如果需要解构 prop,可以通过使用 setup
函数中的 来安全地完成此操作。
// MyBook.vue
import { toRefs } from 'vue'
const { title } = toRefs(props)
console.log(title.value)
}
上下文
传递给 setup
函数的第二个参数是 context
。context
是一个普通的 JavaScript 对象,它暴露三个组件的 property:
context
是一个普通的 JavaScript 对象,也就是说,它不是响应式的,这意味着你可以安全地对 context
使用 ES6 解构。
export default {
setup(props, { attrs, slots, emit }) {
...
}
}
执行 setup
时,组件实例尚未被创建。因此,你只能访问以下 property:
props
attrs
slots
换句话说,你将无法访问以下组件选项:
data
computed
methods
如果 setup
返回一个对象,则可以在组件的模板中像传递给 的 props
property 一样访问该对象的 property:
注意,从 setup
返回的 refs 在模板中访问时是的,因此不应在模板中使用 .value
。
// 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])
}
在 setup()
内部,this
不会是该活跃实例的引用,因为 setup()
是在解析其它组件选项之前被调用的,所以 setup()
内部的 this
的行为与其它选项中的 this
完全不同。这在和其它选项式 API 一起使用 setup()
时可能会导致混淆。