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