Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Konstruktor HTMLElement

`HTMLElement` je osnovna klasa za samostalne prilagođene elemente. Njezin se konstruktor u potklasi poziva putem `super()`, a ne izravno s `new HTMLElement()`.

Verzija: Current web platform; runtime support varies

Sintaksa

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

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

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

Konstruktor HTMLElement dio je sučelja web-platforme dostupnog preko Window, a ne ugrađeni dio ECMAScripta. Sintaksa klasa potječe iz ECMAScripta 2015, ali algoritam za konstrukciju HTML elemenata i registar prilagođenih elemenata osigurava preglednik. I new HTMLElement() i HTMLElement() bacaju iznimku TypeError. Običan HTML element stvori pomoću document.createElement("div").

Za samostalni prilagođeni element napiši klasu s extends HTMLElement i registriraj je pomoću customElements.define() pod valjanim nazivom koji sadrži spojnicu. Ako pišeš vlastiti constructor, prva naredba mora biti super() bez argumenata, prije uporabe this. JavaScript prosljeđuje new.target osnovnom konstruktoru, a platforma traži definiciju prema identitetu konstruktora, ne prema nazivu proslijeđenom u super(). Pri uporabi new s neregistriranom potklasom super() baca iznimku TypeError.

Nakon registracije new StatusBadge() i document.createElement("cktis-status-badge") stvaraju po novu instancu u imenskom prostoru HTML-a bez umetanja u dokument. Kad se postojeći element nadogradi na registriranu klasu, super() daje pristup istom čvoru kao this. U konstruktoru postavi početno stanje instance, ali ne čitaj i ne dodaj atribute ni podređene čvorove. Poslove za koje element mora biti povezan s dokumentom smjesti u connectedCallback(), koji se može izvršiti više puta.

Prilagođeni ugrađeni element zahtijeva odgovarajuće sučelje, primjerice HTMLButtonElement, i opciju { extends: "button" } pri registraciji. Podrška ovisi o izvršnom okruženju: sama usklađenost s ECMAScriptom ne osigurava te DOM API-je, a podrška za samostalne elemente ne znači podršku za prilagođene ugrađene elemente.

Primjeri

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

Rezultat

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

Prva dva retka pokazuju da ne uspijevaju ni izravno stvaranje ni stvaranje instance potklase prije registracije. Nakon registracije oba postupka daju instancu `StatusBadge` sa stanjem `ready`, koja još nije povezana s dokumentom (`false`). Za ponovno pokretanje primjera osvježi njegovu stranicu u pregledniku.

Povezane lekcije

  • JavaScript · Lekcija 38 · Srednje · Verzija: 3
  • JavaScript · Lekcija 39 · Srednje · Verzija: 3

Izvori