这篇文章发布于 2018年03月20日,星期二,23:47,归类于 HTML相关。 阅读 36154 次, 今日 4 次 6 条评论
by zhangxinxu from http://www.zhangxinxu.com/wordpress/?p=7424
本文可全文转载,但需得到原作者书面许可,同时保留原作者和出处,摘要引流则随意。
一、了解HTMLUnknownElement元素
在网页中,随便写一个标签,例如:
<username>zhangxinxu</username>
这个<username>就是一个HTMLUnknownElement元素。
简单测试下:
document.querySelector('username') instanceof HTMLUnknownElement; // 返回值是true
在HTML规范中,HTMLUnknownElement元素是一个被认可的合法的元素,CSS可以无障碍使用,例如:
username {
text-transform: uppercase;
}
则实时效果如下(用户名大写):
HTMLUnknownElement继承HTMLElement中的方法,因此,基本上,常用的HTML方法都是可以畅快使用的,例如,文字变红色,可以直接:
document.querySelector('username').style.color = 'red';
我们不一样
在HTML世界中,HTMLUnknownElement和HTMLDivElement,HTMLSpanElement等等都是平级的,平起平坐,都是HTMLElement的子集。那其中有没有什么不一样的地方呢?
区别在于,规范中的一部分HTML元素自己带有一些特殊的属性或者方法,例如,表单元素HTMLFormElement元素有reset()方法,novalidate属性。然而,HTMLUnknownElement自己是没有携带任何属性和方法。
这使其是一件好事,我们就可以为HTMLUnknownElement扩展非常私有的方法,而不用担心会影响其他元素。例如来说,默认所有HTMLUnknownElement元素的display计算值都是inline,我们可以扩展了block()方法使其块状化。
HTMLUnknownElement.prototype.block = function () {
this.style.display = 'block';
};
此时执行document.querySelector('username').block()就可以让<username>元素块状化了。
从实用角度讲,基于原型扩展的方法,还不算太智能,要是可以针对不同标签类型进行扩展就更好了,这个后面会介绍。
二、HTMLUnknownElement与自定义元素(Custom Elements)
我之前以为写一个规范以外的标签元素就是自定义元素,后来发现不是的。HTMLUnknownElement与自定义元素并不能直接相等,甚至可以说是陌路两人。
W3规范中,对自定义元素的定义是中间必须要有短横线(就是键盘上的减号)连接,并且浏览器也是这么认为的,例如:
document.createElement('username') instanceof HTMLUnknownElement; // 返回值是true
document.createElement('user-name') instanceof HTMLUnknownElement; // 返回值是false

从这一点看,HTMLUnknownElement一定不是自定义元素,换句通俗的话解释就是“自定义元素不等于随便定义元素”。
虽然都是自己命名的标签,多一个短横和没有短横去区别之大,远不是外面看上去的那点区别。
规范和浏览器为有短横的自定义元素开了很多很棒的特权,可以让我们实现很多很棒的事情!
三、自定义元素(Custom Elements)专场
自定义元素有哪些特权呢?我们先从目前可以在实际项目中应用的特性说起。
1. ES6下的继承与自定义HTML元素类型
对于自定义元素,规范提供了一套各种HTML特性可继承可扩展的机制,通常使用套路如下:
- ES6 class继承;
- customElements定义元素;
先说说目前支持相对较好的匿名自定义元素(Autonomous custom elements),也就是继承自HTMElement的用法。
例如,我们实现一个基于rows属性多行打点效果的小组件。
注意,下面的演示代码基本上可以作为各类自定义元素(甚至Web Components)使用的模板,很有用,例如,对于学习类似Vue的实时刷新很有帮助,对于学习Shadow DOM和Web Components也是非常好的案例。以后要实现类似功能,代码拷贝过去,修改修改即可!
class HTMLEllElement extends HTMLElement {
// 指定观察的属性,这样attributeChangedCallback才会起作用
static get observedAttributes() { return ['rows']; }
constructor() {
// constructor中首先第一件事情就是调用 super
// super指代了整个prototype或者__proto__指向的对象
// 这一步免不了的
super();
// 创建shadow元素,实际上,从本例要实现的效果讲,
// 直接元素上设置也可以,就是HTML丑了点,CSS要放在外部
// 且目前火狐并不支持shadow dom可以不用,
// 但一切为了学习,还是展现下现代web组件的实现方式
var shadow = this.attachShadow({
// open外部可访问(通过element.shadowRoot),closed则不能
mode: 'open'
});
// 文本内容移动到shadow dom元素中
var div = document.createElement('div');
div.innerHTML = this.innerHTML;
this.innerHTML = '';
var style = document.createElement('style');
shadow.appendChild(style);
shadow.appendChild(div);
}
// 下面4个方法为常用生命周期
connectedCallback() {
console.log('自定义元素加入页面');
// 执行渲染更新
this._updateRendering();
}
disconnectedCallback() {
// 本例子该生命周期未使用,占位示意
console.log('自定义元素从页面移除');
}
adoptedCallback() {
// 本例子该生命周期未使用,占位示意
console.log('自定义元素转移到新页面');
}
attributeChangedCallback(name, oldValue, newValue) {
console.log('自定义元素属性发生变化');
this._rows = newValue;
// 执行渲染更新
this._updateRendering();
}
// 设置直接get/set rows属性的方法
get rows() {
return this._rows;
}
set rows(v) {
this.setAttribute('rows', v);
}
_updateRendering() {
// 根据变化的属性,改变组件的UI
var shadow = this.shadowRoot;
var childNodes = shadow.childNodes;
var rows = this._rows;
for (var i = 0; i < childNodes.length; i++) {
if (childNodes[i].nodeName === 'STYLE') {
childNodes[i].textContent = `div {
display: -webkit-box;
-webkit-line-clamp: ${rows};
-webkit-box-orient: vertical;
overflow: hidden;
}`;
}
}
}
}
// 定义x-ell标签元素为多行打点元素
customElements.define('x-ell', HTMLEllElement);
上面代码看上去很长,实际上,也就2部分,一个class继承,一个customElements.define注册。个中细节参见注释,是非常好的学习案例。
那实现了什么效果呢?
很棒的效果,我们直接在页面中写入如下CSS和HTML:
x-ell {
display: block;
}
<x-ell rows="2">对于现代浏览器,例如webkit内核的浏...组合如下。</x-ell>
这段文字如果超过2行,就会自动在末尾打点。可以看到,页面上没有任何关于打点相关CSS代码的设置,因为全部在自定义HTMLEllElement的时候写在Shadow DOM中了。
如果想要3行打点,也非常简单,直接设置rows为3即可。我们可以直接手动修改:
<x-ell rows="3">
也可以直接一行JS直接修改属性:
document.querySelector('x-ell').rows = '3';
浏览器会自动渲染成3行文字打点,这就是现代Web Components组件的模样。
眼见为实,您可以狠狠地点击这里:HTML5自定义元素与rows属性直接控制几行打点demo
效果如下Gif截屏所示,点击按钮设置rows为3,然后3行打点:

rows属性的表现就好像<textarea>元素的rows属性一样,修改后直接触发了元素本身UI的变化,而且是实时的。这就是自定义元素,自己定义一个元素,可以和原生元素一样的行为和特性,是不是很酷!
然而兼容性问题不容忽视,如果只考虑ES6继承特性,Firefox,Safari等浏览器也是可以用的,也就是移动端冒进下也是可以使用的。但是自定义元素注册,以及Shadow DOM等特性目前就Chrome,Android以及UC等浏览器支持,因此,只能用在一些内部产品(如中后台管理系统、内部工具)上。Firefox目前想要支持可以开启实验功能,about:config,然后设置dom.webcomponents.customelements.enabled为true,以及dom.webcomponents.shadowdom.enabled为true。

不过,目前Firefox在开发,Edge在考虑,相信一统江山的时候很快就会到来。
小疑问
customElements.define自定义元素的时候,标签可否没有短横线,例如:
customElements.define('ell', HTMLEllElement);
答案是,不可以,非短横线自定义元素不认为是合法元素,于是会报错。

下面再看来下目前还没有浏览器支持,但即将支持的定制内置元素(Customized built-in elements)。
什么意思呢?上面自定义元素我们都是继承于HTMLElement,实际上,HTMLElement还有非常非常都的内置子集元素,例如上面提到的HTMLDivElement,HTMLSpanElement,HTMLFormElement元素等,每一种类型标签几乎都对应一种内置元素。
所谓“定制内置元素”,指的就是我们的自定义元素继承自这些内置元素。
举个例子,我们希望定义一个继承<form>元素的自定义元素,名为custom-form,可以这么处理:
class HTMLCustomFormElement extends HTMLFormElement { /* 略 */ }
customElements.define('custom-form', HTMLCustomFormElement);
此时,元素<custom-form>就有了原生<form>的各种属性和方法,例如直接可以使用reset()方法重置内部表单元素的值。
这种特性在我们实际开发的时候有什么用呢?
举例来说,在HTML标准中,<form>元素是不能相互嵌套的,这就导致一个问题,当我们需要局部重置表单内的某些属性值的时候,就不能使用reset()方法,因为会误伤其他可能已经输入的值。
例如表单中有很多输入信息,外加一个图片上传。需求是图片选择即上传完毕,此时需要在图片Ajax上传完毕后重置file类型input的值,IE下值重置不像Chrome,可以直接设置value为空,最佳做法直接<form>元素的reset()方法,此时,我们就可以在file类型input外面包一层<custom-form>标签,这样,HTML解析时候既没有嵌套问题,又可以使用reset()方法对表单元素进行重置。
当然,上面的分析只是理论上的判断,由于目前没有浏览器支持定制内置元素,因此无法断定是否真的如此,等回头浏览器支持了,我们再看一看究竟。
2. 自定义元素与HTML import引入
自定义元素还可以在HTML模块中使用,目前仅Chrome支持。
大致套路这样的:
- HTML模块注册与构建自定义元素;
- 母页面引入模块;
- 母页面自定义标签自动组件呈现;
例如下面HTML:
<link rel="import" href="module.html"> <zxx-info/>
此时<zxx-info>这个元素在页面上呈现出来的效果就是:

那这个module.html究竟做了什么事情呢?就是自定义<zxx-info>这个元素。
完整代码如下:
<template id="tpl">
<style>
.scope {
contain: content;
}
.scope > img {
float: left;
margin-right: 10px;
}
.scope > p {
margin: 0;
overflow: hidden;
}
</style>
<div class="scope">
<img src="zxx.jpg">
<p>帅哥一枚!</p>
</div>
</template>
<script>
// 定义<zxx-info>
class HTMLZxxInfoElement extends HTMLElement {
constructor() {
super();
// 内部显示信息
this.innerHTML = document.currentScript.ownerDocument.querySelector('#tpl').innerHTML;
}
};
// 注册
customElements.define('zxx-info', HTMLZxxInfoElement);
</script>
两部分,一部分模板,一部分自定义元素定义和注册。都是Web Components中的概念。不展开,大家感受感受即可。
眼见为实,您可以狠狠地点击这里:HTML5自定义元素与HTML import模块引入demo
四、结束语
如果我们平时就使用一些自定义标签定义样式,HTMLUnknownElement用用足矣,简单方便又灵活,什么不符合W3C规范之类的,完全不用在意,规范的哈,你看都有特别的身份标识了,没必要像张灵玉那样过分拘泥,可以学学张楚岚,那才是真智慧。
但是如果你是希望使用自定义标签来开发Web Components组件,得了,标签的短横线还是要加上的。考虑到目前业界几乎没有大规模使用的案例,什么命名规范之类的,其实也不用太在意,怎么开心怎么来就好,你就是先驱者,别人按照你的来,久而久之,也就成了约定俗成的规范了。
好,就这些吧。
抛砖引玉,欢迎交流,感谢阅读!

本文为原创文章,会经常更新知识点以及修正一些错误,因此转载请保留原出处,方便溯源,避免陈旧错误知识的误导,同时有更好的阅读体验。
本文地址:http://www.zhangxinxu.com/wordpress/?p=7424
(本篇完)
- 聊聊JS DOM变化的监听检测与应用 (0.636)
- 巧用两个type=range input实现区域范围选择 (0.313)
- 如何继承自定义元素及其他JS中扩展新方法 (0.313)
- 光速了解HTML shadowrootmode等属性的作用 (0.282)
- Safari不支持build-in自定义元素的兼容处理 (0.231)
- 研究下attachInternals方法,可让普通元素有表单特性 (0.231)
- CSS技术分享: 文字在圆形内沿着弧线边界排版 (0.224)
- ES6模板字符串在HTML模板渲染中的应用 (0.192)
- 介绍两个DOM新方法setHTMLUnsafe和getHTML (0.192)
- 使用::part伪元素改变Shadow DOM的CSS样式 (0.172)
- 盘点HTML字符串转DOM的各种方法及细节 (RANDOM - 0.110)
为什么我引入 ,没效果呢,就个标签 ,没内容
HTML import 草案已从标准规范中移除,官方现在推荐 ES module,新的 Web 组件导入技术还在制定。
我自己封装了一套更方便的 Web components API,欢迎大家指教 —— https://web-cell.tk/
长大居然也在看一人之下
最近正在补一人之下
感觉这个自定义组件是现在各大流行框架都喜欢干的事情,好像就是在浏览器已经封装好各种html标签和css声明的基础上,加一些自己喜欢的标签和相对应的css声明,再添加一些脚本方法,我们好像是不满足于浏览器厂商按照规范给出的这些浏览器特性,偏偏要自己作一堆自定义的东西。浏览器提供的面向大众,基本可以满足日常需求,一些特殊需求可以折中满足(因为特殊需求来源于特殊客户),自定义的方式确实是多样性,更随性,但是对团队长每个成员的要求都很高,就不是像我这种转行培训毕业的页面仔可以流畅驾驭的了,一旦掌握这种自定义的技能,公司的成本必然提升(因为公司要招懂这方面的人,懂这方面的人不可能10K左右就拿下)。到底是好,还是坏
三的1下面,继承自HTMelement,是不是少了个L?