Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Konstruktor HTMLElement

`HTMLElement` je osnovni razred za samostojne elemente po meri. Njegov konstruktor v podrazredu pokličeš s `super()`, ne neposredno z `new HTMLElement()`.

Različica: 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 je del vmesnika spletne platforme, dostopnega prek Window, in ne vgrajeni del ECMAScripta. Sintaksa razredov izvira iz ECMAScripta 2015, algoritem za konstrukcijo elementov HTML in register elementov po meri pa zagotavlja brskalnik. Tako new HTMLElement() kot HTMLElement() sprožita napako TypeError. Navaden element HTML ustvariš z document.createElement("div").

Za samostojni element po meri napiši razred z extends HTMLElement in ga registriraj s customElements.define() pod veljavnim imenom, ki vsebuje vezaj. Če napišeš svoj constructor, mora biti prvi stavek super() brez argumentov, še pred uporabo this. JavaScript posreduje new.target osnovnemu konstruktorju, platforma pa poišče definicijo po identiteti konstruktorja, ne po imenu, podanem v super(). Pri uporabi new z neregistriranim podrazredom super() sproži napako TypeError.

Po registraciji new StatusBadge() in document.createElement("cktis-status-badge") vsak ustvarita nov primerek v imenskem prostoru HTML, ne da bi ga vstavila v dokument. Ko se obstoječi element nadgradi v primerek registriranega razreda, super() zagotovi dostop do istega vozlišča kot this. V konstruktorju nastavi začetno stanje primerka, ne beri in ne dodajaj pa atributov ali podrejenih vozlišč. Opravila, za katera mora biti element povezan z dokumentom, prestavi v connectedCallback(), ki se lahko izvede večkrat.

Prilagojeni vgrajeni element zahteva ustrezen vmesnik, na primer HTMLButtonElement, in možnost { extends: "button" } ob registraciji. Podpora je odvisna od izvajalnega okolja: sama skladnost z ECMAScriptom ne zagotavlja teh vmesnikov DOM, podpora za samostojne elemente pa ne pomeni podpore za prilagojene vgrajene elemente.

Primeri

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

Prvi dve vrstici pokažeta neuspešno neposredno ustvarjanje in neuspešno ustvarjanje primerka podrazreda pred registracijo. Po registraciji oba načina ustvarita primerek `StatusBadge` s stanjem `ready`, ki še ni povezan z dokumentom (`false`). Če želiš primer ponoviti, znova naloži njegovo stran v brskalniku.

Povezane lekcije

  • JavaScript · Lekcija 38 · Srednja · Različica: 3
  • JavaScript · Lekcija 39 · Srednja · Različica: 3

Viri