Web Components 系列（三） —— 创建 Custom Elements

作者：编程三昧

2022 年 2 月 09 日
本文字数：2269 字
阅读完需：约 7 分钟

Web Components系列（三） —— 创建 Custom Elements

前言

根据前面的介绍，我们知道根据是否继承基本 HTML 元素，可以将自定义元素分为两类“

Autonomous custom elements 自主定制元素
Customized built-in elements 自定义内置元素

由此产生了一个疑问：这两者在使用上到底有何区别？

且让我通过本篇文章试着解释一下这个问题。

Autonomous custom elements

自主定制元素，是独立的元素，它不继承其他内建的 HTML 元素。

你可以直接把它们写成 HTML 标签的形式，来在页面上使用。例如 <my-card>，或者是document.createElement("my-card")这样。

示例

下面是一个创建和使用 Autonomous custom elements 的例子：

<!-- index.html --><body>    <my-card></my-card>    <script src="./index.js"></script></body>

复制代码

// index.jsclass MyCard extends HTMLElement {    constructor() {        super();        let shadow = this.attachShadow({ mode: "open" });
        let containerEle = document.createElement("div");        containerEle.style.display = "flex";        containerEle.style.flexDirection = "column"        containerEle.style.margin = "100px";        containerEle.style.border = "1px solid #aaa";
        const headerEle = document.createElement("div");        headerEle.innerText = "名片";        headerEle.style.height = "20px";        headerEle.style.padding = "10px";        headerEle.style.borderBottom = "1px solid blue";
        const bodyEle = document.createElement("div");        bodyEle.innerText = "姓名：编程三昧";        bodyEle.style.padding = "10px";
        containerEle.appendChild(headerEle);        containerEle.appendChild(bodyEle);        shadow.appendChild(containerEle);    }}
customElements.define("my-card", MyCard);

复制代码

其效果如下：

打开开发者工具，查看 DOM 结构，如下图所示：

尝试一

然后，我试着将注册接口传参改为 customElements.define("my-card", MyCard, {extends: "p"});，结果，页面不显示，也无任何报错信息。

尝试二

如果将 MyCard 类改为继承自 HTMLDivElement，即：

// index.jsclass MyCard extends HTMLDivElement{  constructor(){    super();    ……  }}……

复制代码

页面有报错：

尝试三

在自定义元素的构造器的结束部分加入以下代码：

this.style.display = "block";this.style.border = "2px solid #aaa";

复制代码

边框添加成功，这里要注意的是：继承自 HTMLElement 的样式 display 置为 inline，如果不重新设置 display 的值，那么样式效果会显示不出来。

Customized built-in elements

继承自基本的 HTML 元素。在创建时，你必须指定所需扩展的元素，使用时，需要先写出基本的元素标签，并通过 is 属性指定 custom element 的名称。例如<p is="my-card">, 或者 document.createElement("p", { is: "my-card" })。

示例

下面是一个使用 Customized built-in elements 的例子：

<!--index.html-->
<body>    <div is="my-card"></div>    <script src="./index.js"></script></body>

复制代码

// index.js
class MyCard extends HTMLDivElement {    constructor() {        super();        let shadow = this.attachShadow({ mode: "open" });
        let containerEle = document.createElement("div");        containerEle.style.display = "flex";        containerEle.style.flexDirection = "column"        containerEle.style.margin = "100px";        containerEle.style.border = "1px solid #aaa";
        const headerEle = document.createElement("div");        headerEle.innerText = "名片";        headerEle.style.height = "20px";        headerEle.style.padding = "10px";        headerEle.style.borderBottom = "1px solid blue";
        const bodyEle = document.createElement("div");        bodyEle.innerText = "姓名：编程三昧";        bodyEle.style.padding = "10px";
        containerEle.appendChild(headerEle);        containerEle.appendChild(bodyEle);        shadow.appendChild(containerEle);    }}
customElements.define("my-card", MyCard, {extends: "div"});

复制代码

效果跟 Autonomous custom elements 效果相同，其 DOM 结构如下：

尝试一

如果在 index.html 中只使用 my-card 标签，则没有任何显示。

尝试二

如果将父类中的 HTMLDivElement 改为 HTMLElement，页面有报错：

尝试三

如果去掉 customElements.define() 的第三个参数，则无报错也无页面显示。

总结

综合上述，可以总结如下：

Autonomous custom elements 的构造函数只能继承 HTMLElement，且调用 customElements.define() 方法时不需要第三个参数；
HTML 中直接使用 Autonomous custom elements 定义的标签名称即可；
Autonomous custom elements 样式的 display 值默认为 inline，如有需要，可重新设置；
Customized built-in elements 的构造函数一般只能继承可用的基本 HTML 标签类，且调用 customElements.define() 方法时必须要传入第三个参数，第三个参数一般为： {extends: "标签名"}；
HTML 中直接使用 Customized built-in elements 时，需要通过组件构造函数继承类的基本标签名 + is="自定义标签名"。

~ 本文完，感谢阅读！

学习有趣的知识，结识有趣的朋友，塑造有趣的灵魂！
大家好，我是〖编程三昧〗的作者 隐逸王，我的公众号是『编程三昧』，欢迎关注，希望大家多多指教！

发布于: 刚刚阅读数: 2

原文链接:【http://xie.infoq.cn/article/472c608dc1551f1aed1abb77f】。

编程三昧

关注

学习有趣的知识，塑造有趣的灵魂！ 2019.08.30 加入

还未添加个人简介

发布

暂无评论

创作场景

Web Components 系列（三） —— 创建 Custom Elements

前言

Autonomous custom elements

示例

尝试一

尝试二

尝试三

Customized built-in elements

示例

尝试一

尝试二

尝试三

总结

编程三昧

评论