Vue之slot深度复制
Contents
在Vue中,slot
是一个很有用的特性,可以用来向组件内部插入一些内容。slot
就是“插槽”的意思,用大白话说就是:定义组件的时候留几个口子,由用户来决定插入的内容。
例如我们定义一个组件MyComponent
,其包含一个slot
:
1 | Vue.component('MyComponent', { |
当调用<MyComponent>123</MyComponent>
时,会渲染为如下DOM结构:
1 | <div> |
现在又有新需求了,我们希望调用<MyComponent>123</MyComponent>
时,渲染出这样的DOM结构:
1 | <div> |
看起来很容易实现,即再为MyComponent
添加一个slot
:
1 | Vue.component('MyComponent', { |
渲染出的结构也确实如你所愿,唯一美中不足的是控制台有一个小小的Warning:
1 | Duplicate presence of slot "default" found in the same render tree |
如果你不是强迫症患者,这时候你可以收工安心回家睡觉了。直到有一天你的同事向你抱怨,为什么向MyComponent
插入一个自定义组件会渲染不出来?
例如有一自定义组件MyComponent2
:
1 | Vue.component('MyComponent2', { |
当调用<MyComponent><MyComponent2></MyComponent2></MyComponent>
时,预期渲染为如下DOM结构:
1 | <div> |
为什么不能正常工作呢?估计是前面的那个Warning搞得鬼,通过查询发现在Vue 2.0中不允许有重名的slot
:
重名的 Slots 移除
同一模板中的重名已经弃用。当一个 slot 已经被渲染过了,那么就不能在同一模板其它地方被再次渲染了。如果要在不同位置渲染同一内容,可一用 prop 来传递。
文档中提示可以用props
来实现,然而在我的用例中显然是不合适的。经过搜索后,最靠谱的方法是手写render函数,将slot
中的内容复制到其他的位置。
将之前的MyComponent
改为render函数的方式定义:
1 | Vue.component('MyComponent', { |
在上面的定义中我们插入了两个this.$slots.default
,测试下能不能正常工作。然而并没有什么卵用,Vue文档在render函数这一章有以下说明:
VNodes 必须唯一
所有组件树中的 VNodes 必须唯一
这意味着我们不能简单地在不同位置引用this.$slots.default
,必须对slot
进行深度复制。深度复制的函数如下:
1 | function deepClone(vnodes, createElement) { |
上面的核心函数就是cloneVNode()
,它递归地创建VNode,实现深度复制。VNode的属性很多,我并不了解哪些是关键属性,只是参照着Vue的源码一并地复制过来。
基于以上函数,我们更改MyComponent
的定义:
1 | Vue.component('MyComponent', { |
经测试,一切正常。
总结
在Vue 1.0中重名的slots并不会出现什么问题,不知道为什么在2.0中取消了这个功能。我听说React提供了复制Element的标准函数,希望Vue也能提供这个函数,免得大家踩坑。
Author: jingsam
Link: https://jingsam.github.io/2017/03/08/vnode-deep-clone.html
License: 知识共享署名-非商业性使用 4.0 国际许可协议