База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Web Components: потребителски елементи и жизнен цикъл

Web Components са механизми на уеб платформата за създаване на потребителски елементи на интерфейса. Научете как се регистрира клас, който наследява HTMLElement, как се реагира на свързване и разкачване и как се наблюдават атрибути. Това са API на браузъра, а не функции на самия ECMAScript.

Версия: Web-platform APIs, not tied to an ECMAScript edition. The example's exact console output was verified in isolated Chromium 157.0.8103.51 only; this does not establish broader browser compatibility. Node 24 in the repository does not establish browser API support.

Синтаксис

class ExampleElement extends HTMLElement {
  static get observedAttributes() { return ['label']; }
  connectedCallback() { /* initialize or resume */ }
  disconnectedCallback() { /* release external resources */ }
  attributeChangedCallback(name, oldValue, newValue) { /* react to an observed attribute */ }
}
customElements.define('example-element', ExampleElement);

Web Components обхващат потребителски елементи (custom elements), Shadow DOM, както и шаблони и слотове. Тези механизми могат да се комбинират, но потребителският елемент не изисква Shadow DOM. Самостоятелният потребителски елемент е екземпляр на клас, който наследява HTMLElement. Методът customElements.define() регистрира конструктора на този клас под името на елемента. Валидното име трябва да съдържа тире, например cktis-greeting.

В конструктора извикайте super() преди да използвате this; там може да се създаде shadow root чрез attachShadow(). connectedCallback() обработва свързването с документа, а disconnectedCallback() — разкачването. Свързването може да се случва многократно: не дублирайте слушатели или таймери и освобождавайте външните ресурси при разкачване. Shadow DOM капсулира структурата и стиловете, но не е граница за сигурност.

Статичното observedAttributes задава имената на наблюдаваните атрибути. attributeChangedCallback(name, oldValue, newValue) реагира на добавянето, промяната или премахването им; може да се изпълни преди елементът да е свързан. Липсваща стойност се представя с null. Промяната на обикновено JavaScript свойство не променя автоматично атрибут. Примерът използва textContent, за да показва текст, без да го интерпретира като HTML.

Посочените източници са съсредоточени върху потребителските елементи и HTMLElement: стандартът HTML на WHATWG дефинира потребителските елементи, а документацията на MDN описва HTMLElement и обяснява как се използват потребителските елементи. Точният изход на примера в конзолата е проверен само в изолирана инстанция на Chromium 157.0.8103.51. Това не потвърждава съвместимост с други браузъри или версии; проверете дали целевите браузъри поддържат тези API. Нито едно отделно издание на ECMAScript не гарантира Web Components; Node 24 в хранилището също не доказва наличността на API. Примерът изисква среда на браузър.

Примери

(() => {
  class CktisGreeting extends HTMLElement {
    static get observedAttributes() {
      return ['label'];
    }

    constructor() {
      super();
      this.attachShadow({ mode: 'open' });
    }

    connectedCallback() {
      this.render();
    }

    disconnectedCallback() {
      console.log('disconnected');
    }

    attributeChangedCallback(name, oldValue, newValue) {
      if (oldValue !== newValue) this.render();
    }

    render() {
      this.shadowRoot.textContent = `Hello, ${this.getAttribute('label') ?? 'world'}!`;
    }
  }

  if (customElements.get('cktis-greeting')) {
    throw new Error('Reload the page before running this example again.');
  }
  customElements.define('cktis-greeting', CktisGreeting);

  const element = document.createElement('cktis-greeting');
  document.body.append(element);
  console.log(element.shadowRoot.textContent);
  element.setAttribute('label', 'Ada');
  console.log(element.shadowRoot.textContent);
  element.remove();
})();

Резултат

Hello, world!
Hello, Ada!
disconnected

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници