CKTIS / JavaScript
Web Components: lastni elementi in življenjski cikel
Web Components so mehanizmi spletne platforme za izdelavo lastnih elementov uporabniškega vmesnika. Spoznajte registracijo razreda, ki razširja HTMLElement, odzivanje na priklop in odklop ter opazovanje atributov. To so API-ji brskalnika, ne funkcije samega ECMAScripta.
Različica: 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 vključujejo lastne elemente (custom elements), Shadow DOM ter predloge in reže (slots). Te mehanizme je mogoče kombinirati, vendar lastni element ne potrebuje Shadow DOM. Samostojni lastni element je primerek razreda, ki razširja HTMLElement. Metoda customElements.define() registrira konstruktor tega razreda pod imenom elementa. Veljavno ime mora vsebovati vezaj, na primer cktis-greeting.
V konstruktorju pokličite super() pred uporabo this; tam lahko z attachShadow() ustvarite shadow root. connectedCallback() obravnava priklop na dokument, disconnectedCallback() pa odklop. Do priklopa lahko pride večkrat: ne podvajajte poslušalnikov ali časovnikov, ob odklopu pa sprostite zunanje vire. Shadow DOM zagotavlja enkapsulacijo strukture in slogov, ni pa varnostna meja.
Statični observedAttributes določa imena opazovanih atributov. attributeChangedCallback(name, oldValue, newValue) se odzove na njihovo dodajanje, spremembo ali odstranitev; izvede se lahko še pred priklopom elementa. Manjkajočo vrednost predstavlja null. Sprememba običajne lastnosti JavaScript samodejno ne spremeni atributa. Primer uporablja textContent za prikaz besedila, ne da bi ga razlagal kot HTML.
Navedeni viri se osredotočajo na lastne elemente in HTMLElement: standard HTML organizacije WHATWG opredeljuje lastne elemente, dokumentacija MDN pa opisuje HTMLElement in pojasnjuje, kako uporabljati lastne elemente. Natančen izpis primera v konzoli je bil preverjen samo v izolirani instanci brskalnika Chromium 157.0.8103.51. To ne potrjuje združljivosti z drugimi brskalniki ali različicami; preverite podporo za te API-je v ciljnih brskalnikih. Nobena posamezna izdaja ECMAScripta ne zagotavlja Web Components; tudi Node 24 v repozitoriju ne dokazuje, da so API-ji na voljo. Primer zahteva brskalniško okolje.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.