乐趣区

关于web:Web-Components-系列-详解-Slots

前言
相熟 Vue 的同学应该都晓得”插槽(slot)“的概念,通过应用插槽能够让页面内容的组织更加灵便。

在 Web Components 体系中也有插槽的概念,明天咱们就来具体理解一下 Slots,本文次要包含以下内容:

为什么要用 Slots?
Slots 的相干个性
Slots 的作用
咱们首先来看一个模板元素:

<template>
    <div class = "header">MY CARD</div>
    <div class="details">
        My name is 编程三昧。</div>
</template>
复制代码

既然是模板,那就意味着在很多中央都会应用到它,然而,这里会存在一个问题:所有应用这个模板的中央都将显示模板中的内容,即并不是所有人的名字都叫”编程三昧“。

在这种状况下,叫其余名字的人是没法应用这个模板的,显然,这就和应用模板的初衷相违反了,这个模板的应用范畴太过狭小,不存在通用性。

想要使得这个模板具备通用性,其关键点在于 .details 中显示的内容是否具备通用性。

开动脑筋想一想,咱们是不是能够将其中的”编程三昧“设为动静内容,谁应用这个模板,谁就传入本人的名字。恰好,Slots(插槽)就能够实现这种成果,具体如下:

<!-- 在模板中应用 slot 进行占位 -->
<template id="cardTmp">
    <div class="header">MY CARD</div>
    <div class="details">
        My name is <slot name="userName"> 编程三昧 </slot>。</div>
</template>

<!-- 在应用下面模板的自定义元素中给 slot 传值 -->
<my-card>
    <span slot="userName"> 插槽传值 </slot>
</my-card>

<my-card>
    <span slot="userName">web Components</slot>
</my-card>
复制代码

其对应的 JS 代码如下:

class MyCard extends HTMLElement {constructor () {super();
        const template = document.getElementById('cardTmp');
        const templateContent = template.content;

        this.attachShadow({mode: 'open'}).appendChild(templateContent.cloneNode(true)
        );
    }
}
customElements.define('my-card', MyCard);
复制代码

实现成果:

通过下面的例子,咱们能够用一句话总结 Slots 的作用:Slots 的作用就是给模板元素传值,加强模板元素的灵活性和通用性。

Slots 的相干个性
对于 Slots 的相干个性,我通过问答的模式逐个解释。

Slots 的 name 属性有什么作用?
带有指定 name 的 Slots 被称为”具名插槽“,name 是 slot 的惟一标识。

在引入插槽内容的元素上须要应用与 Slots.name 值雷同的 slot 属性。看上面的代码:

<template id="cardTmp">
    <div class="header">MY CARD</div>
    <div class="details">
        My name is <slot name="userAge">19</slot>。</div>
</template>
<my-card>
    <span slot="userName"> 编程三昧 </slot>
</my-card>

<my-card>
    <span slot="userName">web Components</slot>
</my-card>

<script>
    class MyCard extends HTMLElement {constructor () {super();
            const template = document.getElementById('cardTmp');
            const templateContent = template.content;

            this.attachShadow({mode: 'open'}).appendChild(templateContent.cloneNode(true)
            );
        }
    }
    customElements.define('my-card', MyCard);
</script>
复制代码

运行成果:

因为传入的 slot 属性值和 Slots 的 name 属性值对不上,所以 Slots 未被插入。

传值时的 slot 属性值必须和 Slots 的 name 属性值保持一致。

不给 Slots 传值会怎么?
将下面两个自定义元素 my-card 中的 span 元素去掉,不传任何值,即改成这样:

<my-card></my-card>
复制代码
运行后的成果:

能够看到,如果不给 Slots 传值,那么 Slots 会显示它本人预设的内容。

其实联合以上两点,还能够得出一个论断:如果有援用 Slots,那只有对应 name 的 Slots 内容会被显示,其余的 Slots 皆不显示。

失常 DOM 中能够应用 Slots 吗?
这里的”失常 DOM“是绝对于 Shadow DOM 来说的,指的是页面所在的文档对象。

代码如下:

<slot name="userName">Slots 预设值 </slot>
<div slot="userName">bcsm</div>
复制代码

显示如下:

总结:失常 DOM 中应用 Slots,它会间接渲染在页面上,切不具备插槽成果。

Slots 是不是必须用在 Templates 中?
咱们后面看到的例子中,Slots 是在 Templates 中,那是不是意味着 Slots 必须要用在 Templates 中能力失效呢?

因为曾经验证过在失常 DOM 中的 Slots 是有效的,所以咱们在 Shadow DOM 中做个测试,代码如下:

<body>
    <h1> 不在 Templates 中应用 Slots</h1>
    <div id="templ">
        <slot name="userName"> 这是 Slots 预设值 </slot>
    </div>
    <my-paragraph>
        <span slot="userName"> 编程三昧 </span>
    </my-paragraph>
    <script>
        class MyParagraph extends HTMLElement {constructor () {super();
                const template = document.getElementById('templ');

                this.attachShadow({mode: 'open'}).appendChild(template.cloneNode(true)
                );
            }
        }
        customElements.define('my-paragraph', MyParagraph);
    </script>
</body>
复制代码

显示成果如下:

从显示成果上能够看到,将蕴含 Slots 的失常 DOM 节点在追加到 Shadow DOM 后,Slots 显示传入的值,也就是说 Slots 是失效了的。

总结:Slots 在 Shadow DOM 中就可失效,并非肯定要用在 Templates 中。

一个自定义元素中能够应用多个同名 Slots 吗?
看代码:

<template id="cardTmp">
    <div class="header">MY CARD</div>
    <div class="details">
        My name is <slot name="userName"> 编程三昧 </slot>。</div>
</template>
<my-card>
    <span slot="userName"> 插槽传值 1 </span>
    <span slot="userName"> 插槽传值 2 </span>
</my-card>

<script>
    class MyCard extends HTMLElement {constructor () {super();
            const template = document.getElementById('cardTmp');
            const templateContent = template.content;

            this.attachShadow({mode: 'open'}).appendChild(templateContent.cloneNode(true)
            );
        }
    }
    customElements.define('my-card', MyCard);
</script>
复制代码

显示成果:

论断:一个 Slots 能够接管多个传入值,且都会解析显示进去。

Slots 的传值元素必须是自定义元素的间接子元素吗?
下面的例子中,所有给 Slots 传值的元素都是自定义元素的子元素,那是不是非间接子元素不行呢?

代码如下:

<template id="cardTmp">
    <div class="header">MY CARD</div>
    <div class="details">
        My name is <slot name="userName"> 编程三昧 </slot>。</div>
</template>
<my-card>
    <div>
        <span slot="userName"> 插槽传值 1 </span>
    </div>
</my-card>

<script>
    class MyCard extends HTMLElement {constructor () {super();
            const template = document.getElementById('cardTmp');
            const templateContent = template.content;

            this.attachShadow({mode: 'open'}).appendChild(templateContent.cloneNode(true)
            );
        }
    }
    customElements.define('my-card', MyCard);
</script>
复制代码

运行成果(传值生效):

论断:给 Slots 传值的元素必须是自定义元素的间接子元素,否则传值生效。

最初
如果你感觉此文对你有一丁点帮忙,点个赞。或者能够退出我的开发交换群:1025263163 互相学习,咱们会有业余的技术答疑解惑

如果你感觉这篇文章对你有点用的话,麻烦请给咱们的开源我的项目点点 star:http://github.crmeb.net/u/defu 不胜感激!

PHP 学习手册:https://doc.crmeb.com
技术交换论坛:https://q.crmeb.com

退出移动版