Web Components：自定义元素与Shadow DOM的

2024-05-16 本文已影响0人天涯学馆

Web Components是现代Web开发中用于创建可重用和封装的自定义HTML元素的一组技术。它包括Custom Elements、Shadow DOM、HTML Templates和Slots。

定义自定义元素

定义一个新的HTML元素，这可以通过customElements.define方法完成

class MyElement extends HTMLElement {
  constructor() {
    super(); // 调用超类的构造函数
    this.attachShadow({ mode: 'open' }); // 创建Shadow Root
  }

  connectedCallback() {
    this.shadowRoot.innerHTML = `
      <style>
        /* 在这里定义Shadow DOM内的样式 */
      </style>
      <slot>默认内容</slot>
    `;
  }
}

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

使用Shadow DOM封装样式

Shadow DOM允许我们在组件内部定义私有的CSS样式，这些样式只影响组件内部的元素，不会泄漏到外部DOM。在上面的connectedCallback中，创建了Shadow Root，并添加了样式：

this.shadowRoot.innerHTML = `
  <style>
    div {
      color: blue;
      font-size: 24px;
    }
  </style>
  <div><slot></slot></div>
`;

<my-element>内部的任何文本都将使用蓝色字体和24px的大小。

插入内容

使用<slot>元素，我们可以允许用户向自定义元素内插入内容，这些内容会被插入到Shadow DOM中相应的位置：

<my-element>
  <span>这是插入的内容</span>
</my-element>

在上面的MyElement类中，<slot>元素会显示用户插入的内容。

交互和事件

自定义元素可以有自己的一套事件和交互逻辑。例如，可以添加事件监听器：

class MyElement extends HTMLElement {
  // ...

  disconnectedCallback() {
    // 清理资源或执行断开连接时的操作
  }

  // 添加事件监听器
  buttonClickHandler() {
    console.log('Button clicked!');
  }

  connectedCallback() {
    // ...
    this.shadowRoot.querySelector('button').addEventListener('click', this.buttonClickHandler.bind(this));
  }
}

复用和组合

自定义元素可以嵌套在其他自定义元素中，或者在多个地方重复使用，从而实现组件的复用。

<div>
  <my-element>
    <button>点击我</button>
  </my-element>
  <my-element>
    <button>再次点击我</button>
  </my-element>
</div>

两个<my-element>都可以响应点击事件，并且它们的样式和逻辑都是封装在各自的Shadow DOM内，互不干扰。

属性和属性观察

为了使自定义元素更加灵活和可配置，我们可以为其定义属性，并观察这些属性的变化以响应式地更新组件内部的状态或UI。

定义属性
在自定义元素类中，可以通过observedAttributes静态属性来声明需要观察的属性列表：

static get observedAttributes() {
  return ['my-attribute'];
}

属性变化的响应
然后，通过覆盖attributeChangedCallback方法来响应属性变化：

attributeChangedCallback(name, oldValue, newValue) {
  if (name === 'my-attribute') {
    console.log(`my-attribute changed from ${oldValue} to ${newValue}`);
    // 根据属性变化更新UI或逻辑
  }
}

使用属性
在HTML中，可以通过自定义元素标签设置这些属性：

<my-element my-attribute="someValue"></my-element>

样式隔离与穿透

Shadow DOM提供了样式隔离，但有时我们可能希望某些全局样式也能影响到Shadow DOM内部。可以使用CSS的:host伪类来控制自定义元素本身的样式，而:host-context(selector)则允许根据宿主上下文来改变样式。

如果需要从外部影响Shadow DOM内部的样式，可以利用CSS变量（Custom Properties）：

/* 在全局样式或父组件中定义变量 */
:root {
  --my-color: blue;
}

/* 在Shadow DOM中使用这些变量 */
<style>
  div {
    color: var(--my-color);
  }
</style>

生命周期方法

除了connectedCallback, disconnectedCallback, 和 attributeChangedCallback，自定义元素还有其他生命周期方法，比如adoptedCallback，当元素被移动到新的文档时调用。

性能考量

懒加载与按需创建：确保自定义元素只在需要时创建和加载，避免不必要的性能损耗。
优化Shadow DOM：尽量减少Shadow DOM的深度和复杂度，避免过度使用复杂的CSS选择器，因为它们可能影响到渲染性能。

跨框架兼容性

Web Components设计为原生Web标准，这意味着它们可以在任何支持Web Components的浏览器中工作，不论使用的是Angular、React还是Vue等前端框架，都能无缝集成。