CKTIS / JavaScript
Web Components: vlastné prvky a životný cyklus
Web Components sú mechanizmy webovej platformy na tvorbu vlastných prvkov rozhrania. Zistite, ako registrovať triedu rozširujúcu HTMLElement, reagovať na pripojenie a odpojenie a sledovať atribúty. Ide o API prehliadača, nie o funkcie samotného ECMAScriptu.
Verzia: 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.
Syntax
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 zahŕňajú vlastné prvky (custom elements), Shadow DOM, šablóny a sloty. Tieto mechanizmy možno kombinovať, vlastný prvok však Shadow DOM nepotrebuje. Samostatný vlastný prvok je inštanciou triedy, ktorá rozširuje HTMLElement. Metóda customElements.define() registruje konštruktor tejto triedy pod názvom prvku. Platný názov musí obsahovať spojovník, napríklad cktis-greeting.
V konštruktore zavolajte super() pred použitím this; pomocou attachShadow() sa v ňom dá vytvoriť shadow root. connectedCallback() spracúva pripojenie k dokumentu a disconnectedCallback() odpojenie. Pripojenie môže nastať opakovane: neduplikujte poslucháče ani časovače a pri odpojení uvoľnite externé zdroje. Shadow DOM zapuzdruje štruktúru a štýly, nie je však bezpečnostnou hranicou.
Statická vlastnosť observedAttributes určuje názvy sledovaných atribútov. attributeChangedCallback(name, oldValue, newValue) reaguje na ich pridanie, zmenu alebo odstránenie; môže sa spustiť ešte pred pripojením prvku. Chýbajúca hodnota je reprezentovaná ako null. Zmena bežnej vlastnosti JavaScriptu automaticky nezmení atribút. Príklad používa textContent na zobrazenie textu bez jeho interpretácie ako HTML.
Uvedené zdroje sa zameriavajú na vlastné prvky a HTMLElement: štandard HTML od WHATWG definuje vlastné prvky a dokumentácia MDN opisuje HTMLElement a vysvetľuje, ako vlastné prvky používať. Presný výstup príkladu v konzole bol overený iba v izolovanej inštancii prehliadača Chromium 157.0.8103.51. To nedokazuje kompatibilitu s inými prehliadačmi alebo verziami; overte podporu týchto API v cieľových prehliadačoch. Žiadna jednotlivá edícia ECMAScriptu Web Components nezaručuje; ani Node 24 v repozitári nedokazuje dostupnosť API. Príklad vyžaduje prostredie prehliadača.
Prí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ýsledok
Hello, world! Hello, Ada! disconnected
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.