WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLElement-Konstruktor

`HTMLElement` ist die Basisklasse für autonome benutzerdefinierte Elemente. Ihr Konstruktor wird in einer Unterklasse über `super()` aufgerufen, nicht direkt mit `new HTMLElement()`.

Version: Current web platform; runtime support varies

Syntax

class StatusBadge extends HTMLElement {
  constructor() {
    super();
    // Initialize instance state here.
  }
}

customElements.define("cktis-status-badge", StatusBadge);

new StatusBadge();
document.createElement("cktis-status-badge");

Der HTMLElement-Konstruktor gehört zu einer Webplattform-Schnittstelle, die über Window verfügbar ist. Er ist kein eingebauter Bestandteil von ECMAScript. Die Klassensyntax stammt aus ECMAScript 2015, aber der Browser stellt den Konstruktoralgorithmus für HTML-Elemente und die Registrierung benutzerdefinierter Elemente bereit. Sowohl new HTMLElement() als auch HTMLElement() lösen einen TypeError aus. Ein gewöhnliches HTML-Element erstellst du mit document.createElement("div").

Für ein autonomes benutzerdefiniertes Element schreibst du eine Klasse mit extends HTMLElement und registrierst sie über customElements.define() unter einem gültigen Namen mit Bindestrich. Wenn du einen constructor schreibst, muss super() ohne Argumente die erste Anweisung sein, noch vor jedem Zugriff auf this. JavaScript reicht new.target an den Basiskonstruktor weiter. Die Plattform sucht die Definition anhand der Identität des Konstruktors, nicht anhand eines an super() übergebenen Namens. Bei new mit einer nicht registrierten Unterklasse löst super() einen TypeError aus.

Nach der Registrierung erzeugen new StatusBadge() und document.createElement("cktis-status-badge") jeweils eine neue Instanz im HTML-Namensraum, ohne sie ins Dokument einzufügen. Wird ein vorhandenes Element auf die registrierte Klasse aktualisiert, stellt super() denselben Knoten als this bereit. Initialisiere im Konstruktor den Instanzzustand, aber lies dort keine Attribute oder Kindknoten und füge auch keine hinzu. Was eine Verbindung zum Dokument voraussetzt, gehört in connectedCallback(); dieser Aufruf kann sich wiederholen.

Ein angepasstes eingebautes Element benötigt die passende Schnittstelle, etwa HTMLButtonElement, und die Registrierungsoption { extends: "button" }. Die Unterstützung hängt von der Laufzeitumgebung ab: ECMAScript-Konformität allein stellt diese DOM-APIs nicht bereit, und Unterstützung für autonome Elemente bedeutet nicht automatisch Unterstützung für angepasste eingebaute Elemente.

Beispiele

<!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>

Ergebnis

TypeError
TypeError
cktis-status-badge true ready false
cktis-status-badge true ready false

Die ersten beiden Zeilen zeigen, dass die direkte Konstruktion sowie die Konstruktion der Unterklasse vor der Registrierung fehlschlagen. Danach liefern beide Wege eine `StatusBadge`-Instanz mit dem Status `ready`, die noch nicht mit dem Dokument verbunden ist (`false`). Lade die Beispielseite im Browser neu, um das Beispiel erneut auszuführen.

Zugehörige Lektionen

  • JavaScript · Lektion 38 · Mittlere Stufe · Version: 3
  • JavaScript · Lektion 39 · Mittlere Stufe · Version: 3

Quellen