女王控的博客

HTMLUnknownElement与HTML5自定义元素

HTMLUnknownElement元素

在网页中,随便写一个标签,例如:

<username>zhangxinxu</username>

这个<username>就是一个HTMLUnknownElement元素。

document.querySelector('username') instanceof HTMLUnknownElement;    // 返回值是true

在HTML规范中,HTMLUnknownElement元素是一个被认可的合法的元素,CSS可以无障碍使用,例如:

username {
    text-transform: uppercase;
}

则实时效果如下(用户名大写):

ZHANGXINXU

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)

W3规范中,对自定义元素的定义是中间必须要有短横线(就是键盘上的减号)连接,并且浏览器也是这么认为的,例如:

document.createElement('username') instanceof HTMLUnknownElement;    // 返回值是true
document.createElement('user-name') instanceof HTMLUnknownElement;    // 返回值是false

从这一点看,HTMLUnknownElement一定不是自定义元素,换句通俗的话解释就是“自定义元素不等于随便定义元素”。

自定义元素(Custom Elements)

ES6下的继承与自定义HTML元素类型

对于自定义元素,规范提供了一套各种HTML特性可继承可扩展的机制,通常使用套路如下:

  1. ES6 class继承;
  2. 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行,就会自动在末尾打点

<style>
   x-ell {
     display: block;
   }
</style>
<x-ell rows="2">对于现代浏览器,例如webkit内核的浏...组合如下。</x-ell>

如果想要3行打点,也非常简单,直接设置rows为3即可。我们可以直接手动修改:

<x-ell rows="3">

也可以直接一行JS直接修改属性:

document.querySelector('x-ell').rows = '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。

自定义元素与HTML import引入

自定义元素还可以在HTML模块中使用,目前仅Chrome支持。

大致套路这样的:

  1. HTML模块注册与构建自定义元素;
  2. 母页面引入模块;
  3. 母页面自定义标签自动组件呈现;

例如下面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中的概念。

即将支持的定制内置元素(Customized built-in elements)

上面自定义元素我们都是继承于HTMLElement,实际上,HTMLElement还有非常非常多的内置子集元素,例如上面提到的HTMLDivElement,HTMLSpanElement,HTMLFormElement元素等,每一种类型标签几乎都对应一种内置元素。

所谓“定制内置元素”,指的就是我们的自定义元素继承自这些内置元素。

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()方法对表单元素进行重置。

评论

阅读下一篇

如何借助content属性显示CSS var变量值
2019-12-11 22:53:34
0%