函数式组件

之前创建的锚点标题组件是比较简单,没有管理任何状态,也没有监听任何传递给它的状态,也没有生命周期方法。实际上,它只是一个接受一些 prop 的函数。在这样的场景下,我们可以将组件标记为 functional,这意味它无状态 (没有响应式数据),也没有实例 (没有 this 上下文)。一个函数式组件就像这样:

  1. Vue.component('my-component', {
  2. functional: true,
  3. // Props 是可选的
  4. props: {
  5. // ...
  6. },
  7. // 为了弥补缺少的实例
  8. // 提供第二个参数作为上下文
  9. render: function (createElement, context) {
  10. // ...
  11. }
  12. })

注意:在 2.3.0 之前的版本中,如果一个函数式组件想要接收 prop,则 props 选项是必须的。在 2.3.0 或以上的版本中,你可以省略 props 选项,所有组件上的特性都会被自动隐式解析为 prop。

当使用函数式组件时,该引用将会是 HTMLElement,因为他们是无状态的也是无实例的。

在 2.5.0 及以上版本中,如果你使用了单文件组件,那么基于模板的函数式组件可以这样声明:

  1. <template functional>
  2. </template>

组件需要的一切都是通过 context 参数传递,它是一个包括如下字段的对象:

  • props:提供所有 prop 的对象
  • children: VNode 子节点的数组
  • slots: 一个函数,返回了包含所有插槽的对象
  • scopedSlots: (2.6.0+) 一个暴露传入的作用域插槽的对象。也以函数形式暴露普通插槽。
  • data:传递给组件的整个数据对象,作为 createElement 的第二个参数传入组件
  • parent:对父组件的引用
  • listeners: (2.3.0+) 一个包含了所有父组件为当前组件注册的事件监听器的对象。这是 data.on 的一个别名。
  • injections: (2.3.0+) 如果使用了 inject 选项,则该对象包含了应当被注入的属性。 在添加 functional: true 之后,需要更新我们的锚点标题组件的渲染函数,为其增加 context 参数,并将 this.$slots.default 更新为 context.children,然后将 this.level 更新为 context.props.level

因为函数式组件只是函数,所以渲染开销也低很多。

在作为包装组件时它们也同样非常有用。比如,当你需要做这些时:

  • 程序化地在多个组件中选择一个来代为渲染;
  • 在将 childrenpropsdata 传递给子组件之前操作它们。 下面是一个 smart-list 组件的例子,它能根据传入 prop 的值来代为渲染更具体的组件:
  1. var EmptyList = { /* ... */ }
  2. var TableList = { /* ... */ }
  3. var OrderedList = { /* ... */ }
  4. var UnorderedList = { /* ... */ }
  5. Vue.component('smart-list', {
  6. functional: true,
  7. props: {
  8. items: {
  9. type: Array,
  10. required: true
  11. },
  12. isOrdered: Boolean
  13. },
  14. render: function (createElement, context) {
  15. function appropriateListComponent () {
  16. var items = context.props.items
  17. if (items.length === 0) return EmptyList
  18. if (typeof items[0] === 'object') return TableList
  19. if (context.props.isOrdered) return OrderedList
  20. return UnorderedList
  21. }
  22. return createElement(
  23. appropriateListComponent(),
  24. context.data,
  25. context.children
  26. )
  27. }
  28. })

向子元素或子组件传递特性和事件

在普通组件中,没有被定义为 prop 的特性会自动添加到组件的根元素上,将已有的同名特性进行替换或与其进行智能合并

然而函数式组件要求你显式定义该行为:

  1. Vue.component('my-functional-button', {
  2. functional: true,
  3. render: function (createElement, context) {
  4. // 完全透传任何特性、事件监听器、子节点等。
  5. return createElement('button', context.data, context.children)
  6. }
  7. })

通过向 createElement 传入 context.data 作为第二个参数,我们就把 my-functional-button 上面所有的特性和事件监听器都传递下去了。事实上这是非常透明的,以至于那些事件甚至并不要求 .native 修饰符。

如果你使用基于模板的函数式组件,那么你还需要手动添加特性和监听器。因为我们可以访问到其独立的上下文内容,所以我们可以使用 data.attrs 传递任何 HTML 特性,也可以使用 listeners (即 data.on 的别名) 传递任何事件监听器。

  1. <template functional>
  2. <button
  3. class="btn btn-primary"
  4. v-bind="data.attrs"
  5. v-on="listeners"
  6. >
  7. <slot/>
  8. </button>
  9. </template>

slots() 和 children 对比

你可能想知道为什么同时需要 slots()childrenslots().default 不是和 children 类似的吗?在一些场景中,是这样——但如果是如下的带有子节点的函数式组件呢?

  1. <my-functional-component>
  2. <p v-slot:foo>
  3. first
  4. </p>
  5. <p>second</p>
  6. </my-functional-component>

对于这个组件,children 会给你两个段落标签,而 slots().default 只会传递第二个匿名段落标签,slots().foo 会传递第一个具名段落标签。同时拥有 childrenslots(),因此你可以选择让组件感知某个插槽机制,还是简单地通过传递 children,移交给其它组件去处理。