KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLElement-constructor

`HTMLElement` is de basisklasse voor autonome aangepaste elementen. Roep de constructor aan via `super()` in een subklasse, niet rechtstreeks met `new HTMLElement()`.

Versie: 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");

De HTMLElement-constructor hoort bij een interface van het webplatform die via Window beschikbaar is, niet bij de ingebouwde onderdelen van ECMAScript. De klassensyntaxis komt uit ECMAScript 2015, maar de browser levert het constructoralgoritme voor HTML-elementen en het register voor aangepaste elementen. Zowel new HTMLElement() als HTMLElement() levert een TypeError op. Maak een gewoon HTML-element met document.createElement("div").

Voor een autonoom aangepast element schrijf je een klasse met extends HTMLElement en registreer je die met customElements.define() onder een geldige naam met een koppelteken. Schrijf je zelf een constructor, zet dan super() zonder argumenten op de eerste regel als eerste instructie, vóór je this gebruikt. JavaScript geeft new.target door aan de basisconstructor. Het platform zoekt de definitie op aan de hand van de identiteit van de constructor, niet aan de hand van een naam die aan super() wordt meegegeven. Gebruik je new met een niet-geregistreerde subklasse, dan treedt bij super() een TypeError op.

Na registratie maken new StatusBadge() en document.createElement("cktis-status-badge") elk een nieuwe instantie in de HTML-naamruimte, zonder die in het document te plaatsen. Wanneer een bestaand element wordt bijgewerkt naar de geregistreerde klasse, stelt super() diezelfde knoop beschikbaar als this. Initialiseer in de constructor de toestand van de instantie, maar lees daar geen attributen of kindknopen en voeg ze ook niet toe. Zet werk waarvoor het element met het document verbonden moet zijn in connectedCallback(); die methode kan meermaals worden uitgevoerd.

Voor een aangepast ingebouwd element heb je de bijbehorende interface nodig, zoals HTMLButtonElement, plus de registratieoptie { extends: "button" }. Ondersteuning hangt af van de uitvoeromgeving: ECMAScript-conformiteit alleen levert deze DOM-API’s niet, en ondersteuning voor autonome elementen betekent niet dat aangepaste ingebouwde elementen ook worden ondersteund.

Voorbeelden

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

Resultaat

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

De eerste twee regels laten zien dat directe constructie mislukt en dat de subklasse vóór registratie ook niet kan worden geïnstantieerd. Na registratie leveren beide methoden een `StatusBadge`-instantie op met de status `ready` die nog niet met het document verbonden is (`false`). Herlaad de voorbeeldpagina in de browser om het voorbeeld opnieuw uit te voeren.

Gerelateerde lessen

  • JavaScript · Les 38 · Gemiddeld · Versie: 3
  • JavaScript · Les 39 · Gemiddeld · Versie: 3

Bronnen