Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Konstruktor HTMLElement

`HTMLElement` je základní třída autonomních vlastních elementů. Její konstruktor se volá v odvozené třídě pomocí `super()`, ne přímo pomocí `new HTMLElement()`.

Verze: Current web platform; runtime support varies

Syntaxe

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 patří k rozhraní webové platformy dostupnému přes Window, nikoli k vestavěným součástem ECMAScriptu. Syntaxe tříd pochází z ECMAScriptu 2015, ale algoritmus konstrukce elementů HTML a registr vlastních elementů zajišťuje prohlížeč. Jak new HTMLElement(), tak HTMLElement() vyvolá výjimku TypeError. Běžný element HTML vytvoříš pomocí document.createElement("div").

Pro autonomní vlastní element napiš třídu s extends HTMLElement a zaregistruj ji pomocí customElements.define() pod platným názvem se spojovníkem. Pokud píšeš vlastní constructor, jeho prvním příkazem musí být super() bez argumentů, ještě před použitím this. JavaScript předá new.target základnímu konstruktoru a platforma vyhledá definici podle identity konstruktoru, nikoli podle názvu předaného do super(). Při použití new s neregistrovanou odvozenou třídou vyvolá super() výjimku TypeError.

Po registraci vytvoří new StatusBadge() i document.createElement("cktis-status-badge") novou instanci ve jmenném prostoru HTML, aniž ji vloží do dokumentu. Při povýšení existujícího elementu na registrovanou třídu zpřístupní super() tentýž uzel jako this. V konstruktoru nastav výchozí stav instance, ale nečti ani nepřidávej atributy či podřízené uzly. Činnosti vyžadující připojení k dokumentu patří do connectedCallback(), který se může spustit opakovaně.

Přizpůsobený vestavěný element vyžaduje odpovídající rozhraní, například HTMLButtonElement, a volbu { extends: "button" } při registraci. Podpora závisí na běhovém prostředí: samotná shoda s ECMAScriptem tato rozhraní DOM nezajišťuje a podpora autonomních elementů neznamená podporu přizpůsobených vestavěných elementů.

Pří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ýsledek

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

První dva řádky ukazují neúspěšnou přímou konstrukci a neúspěšnou konstrukci odvozené třídy před registrací. Po registraci oba postupy vytvoří instanci `StatusBadge` se stavem `ready`, která ještě není připojena k dokumentu (`false`). Chceš-li příklad spustit znovu, načti jeho stránku znovu v prohlížeči.

Související lekce

  • JavaScript · Lekce 38 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 39 · Středně pokročilá · Verze: 3

Zdroje