Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Konštruktor HTMLElement

`HTMLElement` je základná trieda autonómnych vlastných prvkov. Jej konštruktor sa volá v odvodenej triede pomocou `super()`, nie priamo cez `new HTMLElement()`.

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

Konštruktor HTMLElement patrí k rozhraniu webovej platformy dostupnému cez Window, nie medzi zabudované súčasti ECMAScriptu. Syntax tried pochádza z ECMAScriptu 2015, ale algoritmus vytvárania prvkov HTML a register vlastných prvkov poskytuje prehliadač. new HTMLElement() aj HTMLElement() vyvolajú výnimku TypeError. Bežný prvok HTML vytvoríš pomocou document.createElement("div").

Pre autonómny vlastný prvok napíš triedu s extends HTMLElement a zaregistruj ju pomocou customElements.define() pod platným názvom so spojovníkom. Ak píšeš vlastný constructor, prvým príkazom musí byť super() bez argumentov, ešte pred použitím this. JavaScript odovzdá new.target základnému konštruktoru a platforma vyhľadá definíciu podľa identity konštruktora, nie podľa názvu odovzdaného do super(). Pri použití new s nezaregistrovanou odvodenou triedou vyvolá super() výnimku TypeError.

Po registrácii new StatusBadge() aj document.createElement("cktis-status-badge") vytvoria novú inštanciu v mennom priestore HTML bez vloženia do dokumentu. Pri povýšení existujúceho prvku na zaregistrovanú triedu sprístupní super() ten istý uzol ako this. V konštruktore nastav počiatočný stav inštancie, ale nečítaj ani nepridávaj atribúty či podriadené uzly. Činnosti vyžadujúce pripojenie k dokumentu patria do connectedCallback(), ktorý sa môže vykonať viackrát.

Prispôsobený vstavaný prvok vyžaduje zodpovedajúce rozhranie, napríklad HTMLButtonElement, a voľbu { extends: "button" } pri registrácii. Podpora závisí od prostredia: samotná zhoda s ECMAScriptom nezaručuje dostupnosť týchto rozhraní DOM a podpora autonómnych prvkov neznamená podporu prispôsobených vstavaných prvkov.

Príklady

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

Výsledok

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

Prvé dva riadky ukazujú neúspešnú priamu konštrukciu a neúspešnú konštrukciu odvodenej triedy pred registráciou. Po registrácii oba postupy vytvoria inštanciu `StatusBadge` so stavom `ready`, ktorá ešte nie je pripojená k dokumentu (`false`). Ak chceš príklad spustiť znova, obnov jeho stránku v prehliadači.

Súvisiace lekcie

  • JavaScript · Lekcia 38 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 39 · Stredne pokročilá · Verzia: 3

Zdroje