10.3 具名插槽
往往我们需要灵活的使用插槽进行通用组件的开发,要求父组件每个模板对应子组件中每个插槽,这时我们可以使用<slot>
的name
属性,同样举个简单的例子。
var child = {
template: `<div class="child"><slot name="header"></slot><slot name="footer"></slot></div>`,
}
var vm = new Vue({
el: '#app',
components: {
child
},
template: `<div id="app"><child><template v-slot:header><span>头部</span></template><template v-slot:footer><span>底部</span></template></child></div>`,
})
渲染结果:
<div class="child"><span>头部</span><span>底部</span></div>
接下来我们在普通插槽的基础上,看看源码在具名插槽实现上的区别。
10.3.1 模板编译的差别
父组件在编译AST
阶段和普通节点的过程不同,具名插槽一般会在template
模板中用v-slot:
来标注指定插槽,这一阶段会在编译阶段特殊处理。最终的AST
树会携带scopedSlots
用来记录具名插槽的内容
{
scopedSlots: {
footer: { ··· },
header: { ··· }
}
}
AST
生成render
函数的过程也不详细分析了,我们只分析父组件最终返回的结果(如果对parse, generate
感兴趣的同学,可以直接看源码分析,编译阶段冗长且难以讲解,跳过这部分分析)
with(this){return _c('div',{attrs:{"id":"app"}},[_c('child',{scopedSlots:_u([{key:"header",fn:function(){return [_c('span',[_v("头部")])]},proxy:true},{key:"footer",fn:function(){return [_c('span',[_v("底部")])]},proxy:true}])})],1)}
很明显,父组件的插槽内容用_u
函数封装成数组的形式,并赋值到scopedSlots
属性中,而每一个插槽以对象形式描述,key
代表插槽名,fn
是一个返回执行结果的函数。
10.3.2 父组件vnode生成阶段
照例进入父组件生成Vnode
阶段,其中_u
函数的原形是resolveScopedSlots
,其中第一个参数就是插槽数组。
// vnode生成阶段针对具名插槽的处理 _u (target._u = resolveScopedSlots)
function resolveScopedSlots (fns,res,hasDynamicKeys,contentHashKey) {
res = res || { $stable: !hasDynamicKeys };
for (var i = 0; i < fns.length; i++) {
var slot = fns[i];
// fn是数组需要递归处理。
if (Array.isArray(slot)) {
resolveScopedSlots(slot, res, hasDynamicKeys);
} else if (slot) {
// marker for reverse proxying v-slot without scope on this.$slots
if (slot.proxy) { // 针对proxy的处理
slot.fn.proxy = true;
}
// 最终返回一个对象,对象以slotname作为属性,以fn作为值
res[slot.key] = slot.fn;
}
}
if (contentHashKey) {
(res).$key = contentHashKey;
}
return res
}
最终父组件的vnode
节点的data
属性上多了scopedSlots
数组。回顾一下,具名插槽和普通插槽实现上有明显的不同,普通插槽是以componentOptions.child
的形式保留在父组件中,而具名插槽是以scopedSlots
属性的形式存储到data
属性中。
// vnode
{
scopedSlots: [{
'header': fn,
'footer': fn
}]
}
10.3.3 子组件渲染Vnode过程
子组件在解析成AST
树阶段的不同,在于对slot
标签的name
属性的解析,而在render
生成Vnode
过程中,slot
的规范化处理针对具名插槽会进行特殊的处理,回到normalizeScopedSlots
的代码
vm.$scopedSlots = normalizeScopedSlots(
_parentVnode.data.scopedSlots, // 此时的第一个参数会拿到父组件插槽相关的数据
vm.$slots, // 记录父组件的插槽内容
vm.$scopedSlots
);
最终子组件实例上的$scopedSlots
属性会携带父组件插槽相关的内容。
// 子组件Vnode
{
$scopedSlots: [{
'header': f,
'footer': f
}]
}
10.3.4 子组件渲染真实dom
和普通插槽类似,子组件渲染真实节点的过程会执行子render
函数中的_t
方法,这部分的源码会和普通插槽走不同的分支,其中this.$scopedSlots
根据上面分析会记录着父组件插槽内容相关的数据,所以会和普通插槽走不同的分支。而最终的核心是执行nodes = scopedSlotFn(props)
,也就是执行function(){return [_c('span',[_v("头部")])]}
,具名插槽之所以是函数的形式执行而不是直接返回结果,我们在后面揭晓。
function renderSlot (
name,
fallback, // slot插槽后备内容
props, // 子传给父的值
bindObject
){
var scopedSlotFn = this.$scopedSlots[name];
var nodes;
// 针对具名插槽,特点是$scopedSlots有值
if (scopedSlotFn) { // scoped slot
props = props || {};
if (bindObject) {
if (!isObject(bindObject)) {
warn('slot v-bind without argument expects an Object',this);
}
props = extend(extend({}, bindObject), props);
}
// 执行时将子组件传递给父组件的值传入fn
nodes = scopedSlotFn(props) || fallback;
}···
}
至此子组件通过slotName
找到了对应父组件的插槽内容。