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