3.3.6 函数式组件
之前创建的锚点标题组件是比较简单,没有管理或者监听任何传递给他的状态,也没有生命周期方法。它只是一个接收参数的函数。
在这个例子中,我们标记组件为functional
,这意味它是无状态 (没有data
),无实例 (没有this
上下文)。
一个函数式组件就像这样:
Vue.component('my-component', { functional: true, // 为了弥补缺少的实例 // 提供第二个参数作为上下文 render: function (createElement, context) { // ... }, // Props 可选 props: { // ... } })
注意:在 2.3.0 之前的版本中,如果一个函数式组件想要接受 props,则props
选项是必须的。在 2.3.0 或以上的版本中,你可以省略props
选项,所有组件上的属性都会被自动解析为 props。
在 2.5.0 及以上版本中,如果你使用了单文件组件,那么基于模板的函数式组件可以这样声明:
<template functional> </template>
组件需要的一切都是通过上下文传递,包括:
props
:提供 props 的对象children
: VNode 子节点的数组slots
: slots 对象data
:传递给组件的 data 对象parent
:对父组件的引用listeners
: (2.3.0+) 一个包含了组件上所注册的v-on
侦听器的对象。这只是一个指向data.on
的别名。injections
: (2.3.0+) 如果使用了inject
选项,则该对象包含了应当被注入的属性。
在添加functional: true
之后,锚点标题组件的 render 函数之间简单更新增加context
参数,this.$slots.default
更新为context.children
,之后this.level
更新为context.props.level
。
因为函数式组件只是一个函数,所以渲染开销也低很多。然而,对持久化实例的缺乏也意味着函数式组件不会出现在Vue devtools的组件树里。
在作为包装组件时它们也同样非常有用,比如,当你需要做这些时:
- 程序化地在多个组件中选择一个
- 在将 children, props, data 传递给子组件之前操作它们。
下面是一个依赖传入 props 的值的smart-list
组件例子,它能代表更多具体的组件:
var EmptyList = { /* ... */ } var TableList = { /* ... */ } var OrderedList = { /* ... */ } var UnorderedList = { /* ... */ } Vue.component('smart-list', { functional: true, render: function (createElement, context) { function appropriateListComponent () { var items = context.props.items if (items.length === 0) return EmptyList if (typeof items[0] === 'object') return TableList if (context.props.isOrdered) return OrderedList return UnorderedList } return createElement( appropriateListComponent(), context.data, context.children ) }, props: { items: { type: Array, required: true }, isOrdered: Boolean } })
向子元素或子组件传递特性和事件
在普通组件中,没有被定义为 prop 的特性会自动添加到组件的根元素上,将现有的同名特性替换或与其智能合并。
然而函数式组件要求你显示定义该行为:
Vue.component('my-functional-button', { functional: true, render: function (createElement, context) { // 完全透明的传入任何特性、事件监听器、子结点等。 return createElement('button', context.data, context.children) } })
向createElement
通过传入context.data
作为第二个参数,我们就把my-functional-button
上面所有的特性和事件监听器都传递下去了。事实上这是非常透明的,那些事件甚至并不要求.native
修饰符。
如果你使用基于模板的函数式组件,那么你还需要手动添加特性和监听器。因为我们可以访问到其独立的上下文内容,所以我们可以使用data.attrs
传递任何 HTML 特性,也可以使用listeners
(即data.on
的别名)传递任何事件监听器。
<template functional> <button class="btn btn-primary" v-bind="data.attrs" v-on="listeners" > <slot/> </button> </template>
slots()
和children
对比
你可能想知道为什么同时需要slots()
和children
。slots().default
不是和children
类似的吗?在一些场景中,是这样,但是如果是函数式组件和下面这样的 children 呢?
<my-functional-component> <p slot="foo"> first </p> <p>second</p> </my-functional-component>
对于这个组件,children
会给你两个段落标签,而slots().default
只会传递第二个匿名段落标签,slots().foo
会传递第一个具名段落标签。同时拥有children
和slots()
,因此你可以选择让组件通过slot()
系统分发或者简单的通过children
接收,让其他组件去处理。