CKTIS / JavaScript
Costruttore di HTMLElement
`HTMLElement` è la classe base degli elementi personalizzati autonomi. Il suo costruttore si richiama con `super()` in una sottoclasse, non direttamente con `new HTMLElement()`.
Versione: Current web platform; runtime support varies
Sintassi
class StatusBadge extends HTMLElement {
constructor() {
super();
// Initialize instance state here.
}
}
customElements.define("cktis-status-badge", StatusBadge);
new StatusBadge();
document.createElement("cktis-status-badge");Il costruttore HTMLElement appartiene a un’interfaccia della piattaforma web esposta su Window; non è un costrutto nativo di ECMAScript. La sintassi delle classi risale a ECMAScript 2015, ma è il browser a fornire l’algoritmo di costruzione degli elementi HTML e il registro degli elementi personalizzati. Sia new HTMLElement() sia HTMLElement() generano un TypeError. Per creare un normale elemento HTML, usa document.createElement("div").
Per definire un elemento personalizzato autonomo, scrivi una classe con extends HTMLElement e registrala con customElements.define() usando un nome valido contenente un trattino. Se scrivi un constructor, la sua prima istruzione deve essere super() senza argomenti, prima di usare this. JavaScript inoltra new.target al costruttore base e la piattaforma cerca la definizione in base all’identità del costruttore, non a un nome passato a super(). Usare new con una sottoclasse non registrata genera un TypeError quando si arriva a super().
Dopo la registrazione, new StatusBadge() e document.createElement("cktis-status-badge") creano ciascuno una nuova istanza nello spazio dei nomi HTML senza inserirla nel documento. Quando un elemento esistente viene aggiornato alla classe registrata, super() rende disponibile lo stesso nodo come this. Inizializza nel costruttore lo stato dell’istanza, senza leggere né aggiungere attributi o nodi figli. Affida a connectedCallback() le attività che richiedono che l’elemento sia connesso; il metodo può essere eseguito più volte.
Un elemento nativo personalizzato richiede l’interfaccia corrispondente, ad esempio HTMLButtonElement, e l’opzione di registrazione { extends: "button" }. Il supporto varia a seconda dell’ambiente: la sola conformità a ECMAScript non fornisce queste API del DOM, e il supporto degli elementi autonomi non implica quello degli elementi nativi personalizzati.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>HTMLElement constructor</title>
<script>
{
class StatusBadge extends HTMLElement {
constructor() {
super();
this.status = "ready";
}
}
for (const create of [() => new HTMLElement(), () => new StatusBadge()]) {
try {
create();
} catch (error) {
console.log(error.name);
}
}
customElements.define("cktis-status-badge", StatusBadge);
for (const badge of [new StatusBadge(), document.createElement("cktis-status-badge")]) {
console.log(`${badge.localName} ${badge instanceof StatusBadge} ${badge.status} ${badge.isConnected}`);
}
}
</script>Risultato
TypeError TypeError cktis-status-badge true ready false cktis-status-badge true ready false
Le prime due righe mostrano che falliscono sia la costruzione diretta sia quella della sottoclasse prima della registrazione. Dopo la registrazione, entrambi i metodi producono un’istanza di `StatusBadge` con stato `ready`, non ancora connessa al documento (`false`). Ricarica la pagina dell’esempio nel browser per eseguirlo di nuovo.
Lezioni correlate
- JavaScript · Lezione 38 · Intermedio · Versione: 3
- JavaScript · Lezione 39 · Intermedio · Versione: 3