CustomElementRegistry.upgrade()

CustomElementRegistry接口的upgrade()方法将更新节点子树中所有包含阴影的自定义元素,甚至在它们连接到主文档之前也是如此。

语法

customElements.upgrade(root);

参数

root
待升级的包含阴影的派生元素节点 。如果没有可升级的派生实例,则不会抛出异常。

返回值

空.

示例

摘至HTML 规范:

const el = document.createElement("spider-man");

class SpiderMan extends HTMLElement {}
customElements.define("spider-man", SpiderMan);

console.assert(!(el instanceof SpiderMan)); // not yet upgraded

customElements.upgrade(el);
console.assert(el instanceof SpiderMan);    // upgraded!

规范

Specification Status Comment
HTML Living Standard
customElements.upgrade()
Living Standard Initial definition.

浏览器支持

BCD tables only load in the browser