CKTIS / JavaScript
Web Components: aangepaste elementen en levenscyclus
Web Components zijn mechanismen van het webplatform om aangepaste interface-elementen te bouwen. Leer hoe je een klasse die HTMLElement uitbreidt registreert, reageert op koppelen en ontkoppelen, en attributen observeert. Dit zijn browser-API's, geen functies van ECMAScript zelf.
Versie: 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 omvatten aangepaste elementen (custom elements), Shadow DOM, templates en slots. Deze mechanismen kunnen worden gecombineerd, maar een aangepast element heeft geen Shadow DOM nodig. Een autonoom aangepast element is een instantie van een klasse die HTMLElement uitbreidt. customElements.define() registreert de constructor van die klasse onder de naam van het element. Een geldige naam moet een koppelteken bevatten, zoals cktis-greeting.
Roep in de constructor super() aan voordat je this gebruikt; daar kan met attachShadow() een shadow root worden gemaakt. connectedCallback() handelt de koppeling aan het document af, terwijl disconnectedCallback() de ontkoppeling afhandelt. Koppelen kan meerdere keren gebeuren: voorkom dubbele listeners of timers en geef externe resources vrij bij ontkoppeling. Shadow DOM kapselt structuur en stijlen in, maar is geen beveiligingsgrens.
De statische observedAttributes geeft aan welke attribuutnamen worden geobserveerd. attributeChangedCallback(name, oldValue, newValue) reageert op het toevoegen, wijzigen of verwijderen ervan; de callback kan worden uitgevoerd voordat het element is gekoppeld. Een ontbrekende waarde wordt weergegeven als null. Een gewone JavaScript-eigenschap wijzigen verandert niet automatisch een attribuut. Het voorbeeld gebruikt textContent om tekst weer te geven zonder die als HTML te interpreteren.
De genoemde bronnen richten zich op aangepaste elementen en HTMLElement: de WHATWG HTML Living Standard specificeert aangepaste elementen, en de MDN-documentatie beschrijft HTMLElement en legt uit hoe je aangepaste elementen gebruikt. De exacte console-uitvoer van het voorbeeld is alleen gecontroleerd in een geïsoleerde instantie van Chromium 157.0.8103.51. Dat toont geen compatibiliteit met andere browsers of versies aan; controleer of de beoogde browsers deze API's ondersteunen. Geen enkele ECMAScript-editie garandeert Web Components; ook Node 24 in de repository bewijst niet dat de API's beschikbaar zijn. Het voorbeeld vereist een browseromgeving.
Voorbeelden
(() => {
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();
})();Resultaat
Hello, world! Hello, Ada! disconnected
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.