Maison > Article > interface Web > Quel est le principe de mise en œuvre du slot Vue3 Slot ?
Vue implémente un ensemble d'API de distribution de contenu. La conception de cette API est inspirée du projet de spécification des composants Web, en utilisant l'élément <slot></slot>
comme support de distribution. contenu. <slot></slot>
元素作为承载分发内容的出口。
那么Slot到底是什么呢?Slot其实是一个接受父组件传过来的插槽内容,然后生成VNode并返回的函数。
我们一般是使用 <slot></slot>
这对标签进行接受父组件传过来的内容,那么这对标签最终编译之后是一个创建VNode的函数,我们可以叫做创建插槽VNode的函数。
// <slot></slot>标签被vue3编译之后的内容 export function render(_ctx, _cache, $props, $setup, $data, $options) { return _renderSlot(_ctx.$slots, "default") }
我们可以清楚看到<slot></slot>
标签被Vue3编译之后的就变成了一个叫_renderSlot
的函数。
要使用插槽那就必须存在父子组件。
假设父组件为一下内容:
<todo-button> Add todo </todo-button>
我们在父组件使用了一个todo-button
的子组件,并且传递了Add todo
的插槽内容。
todo-button子组件模版内容
<button class="btn-primary"> <slot></slot> </button>
当组件渲染的时候,<slot></slot>
将会被替换为“Add todo”。
那么这其中底层的原理是什么呢?在理解插槽的底层原理之前,我们还需要回顾一下Vue3的组件运行原理。
组件的核心是它能够产出一坨VNode。对于 Vue 来说一个组件的核心就是它的渲染函数,组件的挂载本质就是执行渲染函数并得到要渲染的VNode,至于什么data/props/computed 这都是为渲染函数产出 VNode 过程中提供数据来源服务的,最关键的就是组件最终产出的VNode,因为这个才是需要渲染的内容。
当Vue3遇到VNode类型为组件时,会进入组件渲染流程。组件渲染的流程就是首先创建组件实例,然后初始化组件实例,在初始化组件实例的时候就会去处理Slot相关的内容。
在源码的runtime-coresrccomponent.ts里面
在函数initSlots里面初始化组件Slot的相关内容
那么initSlots函数长啥样,都干了些什么呢?
runtime-coresrccomponentSlots.ts
首先要判断该组件是不是Slot组件,那么怎么判断该组件是不是Slot组件呢?我们先要回去看一下上面父组件编译之后的代码:
export function render(_ctx, _cache, $props, $setup, $data, $options) { const _component_todo_button = _resolveComponent("todo-button") return (_openBlock(), _createBlock(_component_todo_button, null, { default: _withCtx(() => [ _createTextVNode(" Add todo ") ], undefined, true), _: 1 /* STABLE */ })) }
我们可以看到Slot组件的children内容是一个Object类型,也就是下面这段代码:
{ default: _withCtx(() => [ _createTextVNode(" Add todo ") ], undefined, true), _: 1 /* STABLE */ }
那么在创建这个组件的VNode的时候,就会去判断它的children是不是Object类型,如果是Object类型那么就往该组件的VNode的shapeFlag上挂上一个Slot组件的标记。
如果是通过模板编译过来的那么就是标准的插槽children,是带有_
属性的,是可以直接放在组件实例上的slots
属性。
如果是用户自己写的插槽对象,那么就没有_
属性,那么就需要进行规范化处理,走normalizeObjectSlots
。
如果用户搞骚操作不按规范走,那么就走normalizeVNodeSlots
流程。
我们先看看子组件编译之后的代码:
export function render(_ctx, _cache, $props, $setup, $data, $options) { return (_openBlock(), _createElementBlock("button", { class: "btn-primary" }, [ _renderSlot(_ctx.$slots, "default") ])) }
上面我们也讲过了<slot></slot>
标签被vue3编译之后的就变成了一个叫_renderSlot
的函数。
renderSlot
函数接受五个参数,第一个是实例上的插槽函数对象slots
,第二个是插槽的名字,也就是将插槽内容渲染到指定位置 ,第三个是插槽作用域接收的props
,第四个是插槽的默认内容渲染函数,第五个暂不太清楚什么意思。
作用域插槽是一种子组件传父组件的传参的方式,让插槽内容能够访问子组件中才有的数据 。
子组件模板
<slot username="coboy"></slot>
编译后的代码
export function render(_ctx, _cache, $props, $setup, $data, $options) { return _renderSlot(_ctx.$slots, "default", { username: "coboy" }) }
父组件模板
<todo-button> <template v-slot:default="slotProps"> {{ slotProps.username }} </template> </todo-button>
编译后的代码
export function render(_ctx, _cache, $props, $setup, $data, $options) { const _component_todo_button = _resolveComponent("todo-button") return (_openBlock(), _createBlock(_component_todo_button, null, { default: _withCtx((slotProps) => [ _createTextVNode(_toDisplayString(slotProps.username), 1 /* TEXT */) ]), _: 1 /* STABLE */ })) }
上面讲过renderSlot函数,可以简单概括成下面的代码
export function renderSlots(slots, name, props) { const slot = slots[name] if (slot) { if (typeof slot === 'function') { return createVNode(Fragment, {}, slot(props)) } } }
slots
<slot></slot>
pour accepter le contenu passé par le composant parent. Ensuite, après la compilation finale de cette paire de balises, ce sera une fonction qui créera VNode. . Nous pouvons appeler la fonction qui crée le slot VNode. 🎜{ default: _withCtx((slotProps) => [ _createTextVNode(_toDisplayString(slotProps.username), 1 /* TEXT */) ]), _: 1 /* STABLE */ }🎜On voit clairement que la balise
<slot></slot>
devient une fonction appelée _renderSlot
après avoir été compilée par Vue3. 🎜🎜Comment utiliser les slots🎜🎜Pour utiliser les slots, des composants parent-enfant doivent exister. 🎜🎜Supposons que le composant parent ait le contenu suivant : 🎜_withCtx((slotProps) => [ _createTextVNode(_toDisplayString(slotProps.username), 1 /* TEXT */) ])🎜 Nous utilisons un composant enfant de
todo-button
dans le composant parent et transmettons le contenu de l'emplacement de Add todo
. 🎜🎜Contenu du modèle de sous-composant du bouton Todo🎜<div class="container"> <header> <!-- 我们希望把页头放这里 --> </header> <main> <!-- 我们希望把主要内容放这里 --> </main> <footer> <!-- 我们希望把页脚放这里 --> </footer> </div>🎜Lorsque le composant est rendu,
<slot></slot>
sera remplacé par "Ajouter une tâche". 🎜🎜Revue des principes du rendu des composants🎜🎜Alors, quel est le principe sous-jacent ? Avant de comprendre les principes sous-jacents des slots, nous devons également revoir les principes de fonctionnement des composants Vue3. 🎜🎜Le cœur du composant est qu'il peut produire un tas de VNode. Pour Vue, le cœur d'un composant est sa fonction de rendu. L'essence du montage d'un composant est d'exécuter la fonction de rendu et d'obtenir le VNode à restituer. Quant aux données/accessoires/calculés, ils sont tous utilisés pour fournir des données pour le. fonction de rendu pour générer un VNode. La chose la plus importante à propos du service source est le VNode finalement produit par le composant, car c'est le contenu qui doit être restitué. 🎜🎜Principe d'initialisation du slot🎜🎜Lorsque Vue3 rencontre un composant de type VNode, il entrera dans le processus de rendu du composant. Le processus de rendu du composant consiste à créer d'abord une instance de composant, puis à initialiser l'instance de composant. Lors de l'initialisation de l'instance de composant, le contenu lié à l'emplacement sera traité. 🎜🎜Dans le runtime-coresrccomponent.ts du code source🎜🎜🎜🎜Initialiser le contenu lié au composant Slot dans la fonction initSlots🎜🎜Alors à quoi ressemble la fonction initSlots et que fait-elle ? 🎜🎜runtime-coresrccomponentSlots.ts🎜🎜🎜🎜Tout d'abord, nous devons déterminer si le composant est un composant Slot. Alors, comment déterminer si le composant est un composant Slot ? Il faut d'abord revenir en arrière et jeter un œil au code compilé du composant parent ci-dessus : 🎜<!--子组件--> <div class="container"> <header> <slot name="header"></slot> </header> <main> <slot></slot> </main> <footer> <slot name="footer"></slot> </footer> </div>🎜 Nous pouvons voir que le contenu enfants du composant Slot est de type Objet, qui est le code suivant : 🎜
<!--父组件--> <base-layout> <template v-slot:header> <h2>header</h2> </template> <template v-slot:default> <p>default</p> </template> <template v-slot:footer> <p>footer</p> </template> </base-layout>🎜 Puis quand en créant le VNode de ce composant, il déterminera si ses enfants sont de type Object. S'il est de type Object, alors accrochez une marque de composant Slot sur le shapeFlag du VNode du composant. 🎜🎜S'il est compilé via un modèle, il s'agit d'un slot enfants standard, avec l'attribut
_
, qui est l'attribut slots
qui peut être placé directement sur l'instance du composant. . 🎜🎜Si l'objet slot est écrit par l'utilisateur lui-même, alors il n'a pas l'attribut _
, il doit donc être normalisé à l'aide de normalizeObjectSlots
. 🎜🎜Si le fonctionnement gênant de l'utilisateur ne suit pas les spécifications, suivez le processus normalizeVNodeSlots
. 🎜🎜Analyser le contenu du slot🎜🎜Regardons d'abord le code compilé du sous-composant :🎜export function render(_ctx, _cache, $props, $setup, $data, $options) { const _component_base_layout = _resolveComponent("base-layout") return (_openBlock(), _createBlock(_component_base_layout, null, { header: _withCtx(() => [ _createElementVNode("h2", null, "header") ]), default: _withCtx(() => [ _createElementVNode("p", null, "default") ]), footer: _withCtx(() => [ _createElementVNode("p", null, "footer") ]), _: 1 /* STABLE */ })) }🎜Nous avons également mentionné ci-dessus que la balise
<slot></slot>
est compilée par vue3 Après cela, cela devient une fonction appelée _renderSlot
. 🎜🎜🎜🎜renderSlot
accepte cinq paramètres. Le premier est l'objet de fonction slot slots
sur l'instance, et le second est le nom du slot, qui doit restituer le contenu du slot au Position spécifiée, le troisième est le props
reçu par la portée du slot, le quatrième est la fonction de rendu de contenu par défaut du slot, et le cinquième n'est pas clair ce que cela signifie. 🎜🎜Principe de Scope Slot🎜🎜Scope slot est un moyen pour les composants enfants de transmettre les paramètres des composants parents, permettant au contenu du slot d'accéder aux données uniquement dans les composants enfants. 🎜🎜Modèle de sous-composant🎜export function render(_ctx, _cache, $props, $setup, $data, $options) { return (_openBlock(), _createElementBlock("div", { class: "container" }, [ _createElementVNode("header", null, [ _renderSlot(_ctx.$slots, "header") ]), _createElementVNode("main", null, [ _renderSlot(_ctx.$slots, "default") ]), _createElementVNode("footer", null, [ _renderSlot(_ctx.$slots, "footer") ]) ])) }🎜Code compilé🎜
// renderSlots的简化 export function renderSlots(slots, name, props) { const slot = slots[name] if (slot) { if (typeof slot === 'function') { return createVNode(Fragment, {}, slot(props)) } } }🎜Modèle de composant parent🎜
{ header: _withCtx(() => [ _createElementVNode("h2", null, "header") ]), default: _withCtx(() => [ _createElementVNode("p", null, "default") ]), footer: _withCtx(() => [ _createElementVNode("p", null, "footer") ]), _: 1 /* STABLE */ }🎜Code compilé🎜
<button type="submit"> <slot>Submit</slot> </button>🎜La fonction renderSlot a été mentionnée ci-dessus, qui peut être simplement résumée dans le code suivant🎜
<submit-button></submit-button>🎜
slots code > est le contenu du slot téléchargé par l'instance du composant. En fait, c'est ce contenu 🎜<pre class="brush:php;toolbar:false"><button type="submit">
Submit
</button></pre>🎜name est par défaut, alors ce que slots[name] obtient est la fonction suivante 🎜<pre class="brush:php;toolbar:false"><submit-button>
Save
</submit-button></pre>🎜slot(props) est évidemment slot({ username : "coboy" }), transmettant ainsi les données du composant enfant au contenu du slot du composant parent. 🎜<h3>具名插槽原理</h3>
<p>有时我们需要多个插槽。例如对于一个带有如下模板的 <code><base-layout></base-layout>
组件:<div class="container"> <header> <!-- 我们希望把页头放这里 --> </header> <main> <!-- 我们希望把主要内容放这里 --> </main> <footer> <!-- 我们希望把页脚放这里 --> </footer> </div>
对于这样的情况,<slot></slot>
元素有一个特殊的 attribute:name
。通过它可以为不同的插槽分配独立的 ID,也就能够以此来决定内容应该渲染到什么地方:
<!--子组件--> <div class="container"> <header> <slot name="header"></slot> </header> <main> <slot></slot> </main> <footer> <slot name="footer"></slot> </footer> </div>
一个不带 name
的 <slot></slot>
出口会带有隐含的名字“default”。
在向具名插槽提供内容的时候,我们可以在一个 <template></template>
元素上使用 v-slot
指令,并以 v-slot
的参数的形式提供其名称:
<!--父组件--> <base-layout> <template v-slot:header> <h2>header</h2> </template> <template v-slot:default> <p>default</p> </template> <template v-slot:footer> <p>footer</p> </template> </base-layout>
父组件编译之后的内容:
export function render(_ctx, _cache, $props, $setup, $data, $options) { const _component_base_layout = _resolveComponent("base-layout") return (_openBlock(), _createBlock(_component_base_layout, null, { header: _withCtx(() => [ _createElementVNode("h2", null, "header") ]), default: _withCtx(() => [ _createElementVNode("p", null, "default") ]), footer: _withCtx(() => [ _createElementVNode("p", null, "footer") ]), _: 1 /* STABLE */ })) }
子组件编译之后的内容:
export function render(_ctx, _cache, $props, $setup, $data, $options) { return (_openBlock(), _createElementBlock("div", { class: "container" }, [ _createElementVNode("header", null, [ _renderSlot(_ctx.$slots, "header") ]), _createElementVNode("main", null, [ _renderSlot(_ctx.$slots, "default") ]), _createElementVNode("footer", null, [ _renderSlot(_ctx.$slots, "footer") ]) ])) }
通过子组件编译之后的内容我们可以看到这三个Slot渲染函数
_renderSlot(_ctx.$slots, "header")
_renderSlot(_ctx.$slots, "default")
_renderSlot(_ctx.$slots, "footer")
然后我们再回顾一下renderSlot渲染函数
// renderSlots的简化 export function renderSlots(slots, name, props) { const slot = slots[name] if (slot) { if (typeof slot === 'function') { return createVNode(Fragment, {}, slot(props)) } } }
这个时候我们就可以很清楚的知道所谓具名函数是通过renderSlots渲染函数的第二参数去定位要渲染的父组件提供的插槽内容。父组件的插槽内容编译之后变成了一个Object的数据类型。
{ header: _withCtx(() => [ _createElementVNode("h2", null, "header") ]), default: _withCtx(() => [ _createElementVNode("p", null, "default") ]), footer: _withCtx(() => [ _createElementVNode("p", null, "footer") ]), _: 1 /* STABLE */ }
我们可能希望这个 <button></button>
内绝大多数情况下都渲染“Submit”文本。为了将“Submit”作为备用内容,我们可以将它放在 <slot></slot>
标签内
<button type="submit"> <slot>Submit</slot> </button>
现在当我们在一个父级组件中使用 <submit-button></submit-button>
并且不提供任何插槽内容时:
<submit-button></submit-button>
备用内容“Submit”将会被渲染:
<button type="submit"> Submit </button>
但是如果我们提供内容:
<submit-button> Save </submit-button>
则这个提供的内容将会被渲染从而取代备用内容:
<button type="submit"> Save </button>
这其中的原理是什么呢?我们先来看看上面默认内容插槽编译之后的代码
export function render(_ctx, _cache, $props, $setup, $data, $options) { return (_openBlock(), _createElementBlock("button", { type: "submit" }, [ _renderSlot(_ctx.$slots, "default", {}, () => [ _createTextVNode("Submit") ]) ])) }
我们可以看到插槽函数的内容是这样的
_renderSlot(_ctx.$slots, "default", {}, () => [ _createTextVNode("Submit") ])
我们再回顾看一下renderSlot函数
renderSlot
函数接受五个参数,第四个是插槽的默认内容渲染函数。
再通过renderSlot函数的源码我们可以看到,
第一步,先获取父组件提供的内容插槽的内容,
在第二个步骤中,若父组件已提供插槽内容,则使用该插槽内容,否则执行默认的内容渲染函数以获取默认内容。
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!