Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Web Components: vlastní prvky a životní cyklus

Web Components jsou mechanismy webové platformy pro tvorbu vlastních prvků rozhraní. Seznamte se s registrací třídy rozšiřující HTMLElement, reakcemi na připojení a odpojení a sledováním atributů. Jde o API prohlížeče, nikoli o funkce samotného ECMAScriptu.

Verze: 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.

Syntaxe

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 zahrnují vlastní prvky (custom elements), Shadow DOM, šablony a sloty. Tyto mechanismy lze kombinovat, vlastní prvek však Shadow DOM nepotřebuje. Samostatný vlastní prvek je instancí třídy, která rozšiřuje HTMLElement. Metoda customElements.define() registruje konstruktor této třídy pod názvem prvku. Platný název musí obsahovat spojovník, například cktis-greeting.

V konstruktoru zavolejte super() před použitím this; lze v něm pomocí attachShadow() vytvořit shadow root. connectedCallback() zpracovává připojení k dokumentu, zatímco disconnectedCallback() zpracovává odpojení. K připojení může dojít opakovaně: neduplikujte posluchače ani časovače a při odpojení uvolněte externí prostředky. Shadow DOM zapouzdřuje strukturu a styly, není však bezpečnostní hranicí.

Statická vlastnost observedAttributes určuje názvy sledovaných atributů. attributeChangedCallback(name, oldValue, newValue) reaguje na jejich přidání, změnu nebo odebrání; může se spustit ještě před připojením prvku. Chybějící hodnota je reprezentována jako null. Změna běžné vlastnosti JavaScriptu automaticky nezmění atribut. Příklad používá textContent k zobrazení textu, aniž by jej interpretoval jako HTML.

Uvedené zdroje se zaměřují na vlastní prvky a HTMLElement: standard HTML od WHATWG definuje vlastní prvky a dokumentace MDN popisuje HTMLElement a vysvětluje, jak vlastní prvky používat. Přesný výstup příkladu v konzoli byl ověřen pouze v izolované instanci Chromia 157.0.8103.51. To nedokládá kompatibilitu s jinými prohlížeči nebo verzemi; ověřte podporu těchto API v cílových prohlížečích. Žádná jednotlivá edice ECMAScriptu Web Components nezaručuje; ani Node 24 v repozitáři nedokládá dostupnost API. Příklad vyžaduje prostředí prohlížeče.

Příklady

(() => {
  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();
})();

Výsledek

Hello, world!
Hello, Ada!
disconnected

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje