CKTIS / JavaScript
Web Components: elementi personalizzati e ciclo di vita
I Web Components sono meccanismi della piattaforma web per creare elementi di interfaccia personalizzati. Scopri come registrare una classe che estende HTMLElement, gestire la connessione e la disconnessione e osservare gli attributi. Sono API del browser, non funzionalità fornite da ECMAScript stesso.
Versione: 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.
Sintassi
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);I Web Components comprendono elementi personalizzati (custom elements), Shadow DOM, template e slot. Questi meccanismi possono essere combinati, ma un elemento personalizzato non richiede Shadow DOM. Un elemento personalizzato autonomo è un’istanza di una classe che estende HTMLElement. customElements.define() registra il costruttore di quella classe con il nome dell’elemento. Un nome valido deve contenere un trattino, come cktis-greeting.
Nel costruttore, chiama super() prima di usare this; qui è possibile creare uno shadow root con attachShadow(). connectedCallback() gestisce la connessione al documento, mentre disconnectedCallback() gestisce la disconnessione. La connessione può avvenire più volte: evita di duplicare listener o timer e rilascia le risorse esterne alla disconnessione. Shadow DOM incapsula struttura e stili, ma non è un confine di sicurezza.
La proprietà statica observedAttributes specifica i nomi degli attributi osservati. attributeChangedCallback(name, oldValue, newValue) reagisce alla loro aggiunta, modifica o rimozione; può essere eseguito prima che l’elemento sia connesso. Un valore mancante è rappresentato da null. Modificare una normale proprietà JavaScript non modifica automaticamente un attributo. L’esempio usa textContent per mostrare testo senza interpretarlo come HTML.
Le fonti citate si concentrano sugli elementi personalizzati e su HTMLElement: lo standard HTML del WHATWG definisce gli elementi personalizzati, mentre la documentazione di MDN descrive HTMLElement e spiega come usare gli elementi personalizzati. L’output esatto dell’esempio nella console è stato verificato solo in un’istanza isolata di Chromium 157.0.8103.51. Ciò non dimostra la compatibilità con altri browser o versioni; verifica il supporto di queste API nei browser di destinazione. Nessuna singola edizione di ECMAScript garantisce i Web Components; anche Node 24 nel repository non dimostra la disponibilità delle API. L’esempio richiede un ambiente browser.
Esempi
(() => {
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();
})();Risultato
Hello, world! Hello, Ada! disconnected
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.