Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti