Setup

    使用 setup 函数时，它将接受两个参数：

    1. props
    2. context

    让我们更深入地研究如何使用每个参数。

    setup 函数中的第一个参数是 props。正如在一个标准组件中所期望的那样，setup 函数中的 props 是响应式的，当传入新的 prop 时，它将被更新。

    但是，因为 props 是响应式的，你不能使用 ES6 解构，因为它会消除 prop 的响应性。

    如果需要解构 prop，可以通过使用 setup 函数中的 来安全地完成此操作。

    1. // MyBook.vue
    3. import { toRefs } from 'vue'
    5.     const { title } = toRefs(props)
    7.     console.log(title.value)
    8. }

    上下文

    传递给 setup 函数的第二个参数是 context。context 是一个普通的 JavaScript 对象，它暴露三个组件的 property：

    context 是一个普通的 JavaScript 对象，也就是说，它不是响应式的，这意味着你可以安全地对 context 使用 ES6 解构。

    2. export default {
    3.   setup(props, { attrs, slots, emit }) {
    4.     ...
    5.   }
    6. }

    执行 setup 时，组件实例尚未被创建。因此，你只能访问以下 property：

    • props
    • attrs
    • slots

    换句话说，你将无法访问以下组件选项：

    • data
    • computed
    • methods

    如果 setup 返回一个对象，则可以在组件的模板中像传递给 的 props property 一样访问该对象的 property：

    注意，从 setup 返回的 refs 在模板中访问时是的，因此不应在模板中使用 .value。

    1. // MyBook.vue
    3. import { h, ref, reactive } from 'vue'
    5. export default {
    6.   setup() {
    7.     const readersNumber = ref(0)
    8.     const book = reactive({ title: 'Vue 3 Guide' })
    9.     // Please note that we need to explicitly expose ref value here
    10.     return () => h('div', [readersNumber.value, book.title])
    11. }

    在 setup() 内部，this 不会是该活跃实例的引用，因为 setup() 是在解析其它组件选项之前被调用的，所以 setup() 内部的 this 的行为与其它选项中的 this 完全不同。这在和其它选项式 API 一起使用 setup() 时可能会导致混淆。