HTML 自定义元素教程

组件是 Web 开发的方向，现在的热点是 JavaScript 组件，但是 HTML 组件未来可能更有希望。本文就介绍 HTML 组件的基础知识：自定义元素（custom elements）。
一、浏览器处理我们一般都使用标准的 HTML 元素。

Hello World

复制代码

上面代码中，

[/code]就是标准的 HTML 元素。如果使用非标准的自定义元素，会有什么结果？
[code]Hello World

复制代码

上面代码中，

[/code]就是非标准元素，浏览器不认识它。这段代码的运行结果是，浏览器照常显示[code]Hello World

复制代码

，这说明浏览器并没有过滤这个元素。

现在，为自定义元素加上样式。

greeting {

复制代码

display: block;

复制代码

font-size: 36px;

复制代码

color: red;

复制代码

}

复制代码

运行结果如下。

接着，使用脚本操作这个元素。

function customTag(tagName, fn){

复制代码

Array

复制代码

.from(document.getElementsByTagName(tagName))

复制代码

.forEach(fn);

复制代码

}

复制代码

[/code]
[code]function greetingHandler(element) {

复制代码

element.innerHTML = '你好，世界';

复制代码

}

复制代码

[/code]
[code]customTag('greeting', greetingHandler);

复制代码

运行结果如下。

这说明，浏览器对待自定义元素，就像对待标准元素一样，只是没有默认的样式和行为。这种处理方式是写入 HTML5 标准的。

“User agents must treat elements and attributes that they do not understand as semantically neutral; leaving them in the DOM (for DOM processors), and styling them according to CSS (for CSS processors), but not inferring any meaning from them.”

上面这段话的意思是，浏览器必须将自定义元素保留在 DOM 之中，但不会任何语义。除此之外，自定义元素与标准元素都一致。事实上，浏览器提供了一个

HTMLUnknownElement

复制代码

对象，所有自定义元素都是该对象的实例。

var tabs = document.createElement('tabs');

复制代码

[/code]
[code]tabs instanceof HTMLUnknownElement // true

复制代码

tabs instanceof HTMLElement // true

复制代码

上面代码中，tabs是一个自定义元素，同时继承了

HTMLUnknownElement

复制代码

和

HTMLElement

复制代码

接口。
二、HTML import
有了自定义元素，就可以写出语义性非常好的 HTML 代码。

[/code]
[code]

复制代码

微博

复制代码

微信

复制代码

[/code]
上面的代码，一眼就能看出语义。如果将[code]

复制代码

元素的样式与脚本，封装在一个 HTML 文件

share-buttons.html

复制代码

之中，这个元素就可以复用了。使用的时候，先引入

share-buttons.html

复制代码

。

[/code]
然后，就可以在网页中使用[code]

复制代码

了。

[/code]
[code] Title

复制代码

... ...

复制代码

[/code]
[code]HTML imports

复制代码

的更多用法可以参考教程（1，2）。目前只有 Chrome 浏览器支持这个语法。
三、Custom Elements 标准
HTML5 标准规定了自定义元素是合法的。然后，W3C 就为自定义元素制定了一个单独的 Custom Elements 标准。

它与其他三个标准放在一起—- HTML Imports，HTML Template、Shadow DOM—-统称为 Web Components 规范。目前，这个规范只有 Chrome 浏览器支持。
Custom Elements 标准对自定义元素的名字做了限制。
[quote]“自定义元素的名字必须包含一个破折号（-）所以

[/code]、[code]

复制代码

和

[/code]都是正确的名字，而[code]

复制代码

和

[/code]是不正确的。这样的限制使得 HTML 解析器可以分辨那些是标准元素，哪些是自定义元素。”
[/quote][img]https://201903.oss-cn-hangzhou.aliyuncs.com/wc/1811847-d7eaa298de641174df4724c05485a488.jpeg[/img]
注意，一旦名字之中使用了破折号，自定义元素就不是[code]HTMLUnknownElement

复制代码

的实例了。

var xTabs = document.createElement('x-tabs');

复制代码

[/code]
[code]xTabs instanceof HTMLUnknownElement // false

复制代码

xTabs instanceof HTMLElement // true

复制代码

Custom Elements 标准规定了，自定义元素的定义可以使用 ES6 的class语法。

// 定义一个

复制代码

class MyElement extends HTMLElement {...}

复制代码

window.customElements.define('my-element', MyElement);

复制代码

上面代码中，原生的

window.customElements

复制代码

对象的define方法用来定义

Custom Element

复制代码

。该方法接受两个参数，第一个参数是自定义元素的名字，第二个参数是一个 ES6 的class。这个

class

复制代码

使用

get

复制代码

和

set

复制代码

方法定义 Custom Element 的某个属性。

class MyElement extends HTMLElement {

复制代码

get content() {

复制代码

return this.getAttribute('content');

复制代码

}

复制代码

[/code]
[code] set content(val) {

复制代码

this.setAttribute('content', val);

复制代码

}

复制代码

}

复制代码

有了这个定义，网页之中就可以插入

[/code]了。
[code]

复制代码

Hello

复制代码

[/code]
处理脚本如下。
[code]function customTag(tagName, fn){

复制代码

Array

复制代码

.from(document.getElementsByTagName(tagName))

复制代码

.forEach(fn);

复制代码

}

复制代码

[/code]
[code]function myElementHandler(element) {

复制代码

element.textConent = element.content;

复制代码

}

复制代码

[/code]
[code]customTag('my-element', myElementHandler);

复制代码

运行结果如下。

ES6 Class 的一个好处是，可以很容易地写出继承类。

class MyNewElement extends MyElement {

复制代码

// ...

复制代码

}

复制代码

[/code]
[code]customElements.define('my-new-element', MyNewElement);

复制代码

今天的教程就到这里，更多用法请参考谷歌的官方教程。

作者：阮一峰
原文：http://www.ruanyifeng.com/blog/2017/06/custom-elements.html