CustomElementRegistry - 提供了注册自定义元素和查询已注册元素的方法

CustomElementRegistry 接口提供了注册自定义元素和查询已注册元素的方法。要获取它的实例，请使用 window.customElements 属性。

方法

CustomElementRegistry.define()

定义一个新的自定义元素.

CustomElementRegistry.get()

返回指定自定义元素的构造函数，如果未定义自定义元素，则返回 undefined。

CustomElementRegistry.whenDefined()

返回一个空的 promise，它在使用给定名称定义自定义元素时解析。如果已定义该类自定义元素，则会立即返回解析。

实例

以下代码取自我们的 word-count-web-component 示例（也请参阅该在线实例）。请注意我们如何使用 CustomElementRegistry.define() 方法在创建其类后定义自定义元素。

// 为元素创建一个类
class WordCount extends HTMLParagraphElement {
  constructor() {
    // 始终在构造函数中先调用 super
    super();

    // 计算元素的父元素中的单词
    var wcParent = this.parentNode;

    function countWords(node){
      var text = node.innerText || node.textContent
      return text.split(/\s+/g).length;
    }

    var count = 'Words: ' + countWords(wcParent);

    // 创建一个 shadow root
    var shadow = this.attachShadow({mode: 'open'});

    // 创建文本节点并为其添加单词计数
    var text = document.createElement('span');
    text.textContent = count;

    // 将其附加到 shadow root
    shadow.appendChild(text);

    // 元素内容更改时更新计数
    setInterval(function() {
      var count = 'Words: ' + countWords(wcParent);
      text.textContent = count;
    }, 200)

  }
}

// 定义新元素
customElements.define('word-count', WordCount, { extends: 'p' });

注意：CustomElementsRegistry 可通过 Window.customElements 属性获得。

规范

规范	状态	备注
HTML Living Standard CustomElementRegistry 的定义	现行的标准	初始定义。

桌面浏览器兼容性

移动浏览器兼容性

1. 在考虑中

2. 同时支持“自定义内置元素”。

3. 仅支持“自主自定义元素”。

4. 支持“自主自定义元素”但不支持“自定义内置元素”。