CKTIS / JavaScript
Web Components: prilagođeni elementi i životni ciklus
Web Components mehanizmi su web-platforme za izradu prilagođenih elemenata sučelja. Saznajte kako registrirati klasu koja proširuje HTMLElement, reagirati na povezivanje i odspajanje te pratiti atribute. To su API-ji preglednika, a ne značajke samog ECMAScripta.
Verzija: 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.
Sintaksa
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 obuhvaćaju prilagođene elemente (custom elements), Shadow DOM te predloške i slotove. Ti se mehanizmi mogu kombinirati, ali prilagođeni element ne treba Shadow DOM. Samostalni prilagođeni element instanca je klase koja proširuje HTMLElement. Metoda customElements.define() registrira konstruktor te klase pod nazivom elementa. Valjani naziv mora sadržavati crticu, primjerice cktis-greeting.
U konstruktoru pozovite super() prije upotrebe this; ondje se pomoću attachShadow() može stvoriti shadow root. connectedCallback() obrađuje povezivanje s dokumentom, a disconnectedCallback() odspajanje. Povezivanje se može dogoditi više puta: nemojte udvostručavati slušatelje ni mjerače vremena, a pri odspajanju oslobodite vanjske resurse. Shadow DOM enkapsulira strukturu i stilove, ali nije sigurnosna granica.
Statički observedAttributes određuje nazive atributa koji se prate. attributeChangedCallback(name, oldValue, newValue) reagira na njihovo dodavanje, promjenu ili uklanjanje; može se izvršiti prije povezivanja elementa. Vrijednost koja nedostaje predstavlja se kao null. Promjena običnog JavaScript svojstva ne mijenja automatski atribut. Primjer upotrebljava textContent za prikaz teksta bez tumačenja kao HTML-a.
Navedeni izvori usredotočeni su na prilagođene elemente i HTMLElement: WHATWG-ov standard za HTML definira prilagođene elemente, a dokumentacija MDN-a opisuje HTMLElement i objašnjava kako upotrebljavati prilagođene elemente. Točan ispis primjera u konzoli provjeren je samo u izoliranoj instanci preglednika Chromium 157.0.8103.51. To ne potvrđuje kompatibilnost s drugim preglednicima ili verzijama; provjerite podržavaju li ciljni preglednici te API-je. Nijedno pojedino izdanje ECMAScripta ne jamči Web Components; ni Node 24 u repozitoriju ne dokazuje dostupnost API-ja. Primjer zahtijeva okruženje preglednika.
Primjeri
(() => {
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();
})();Rezultat
Hello, world! Hello, Ada! disconnected
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.