CKTIS / JavaScript
Vlastné elementy: sledované atribúty a životný cyklus
Zisti, ako vlastný element vyberá atribúty na sledovanie a ako reaguje na ich zmeny, pripojenie k dokumentu a odpojenie od neho.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
class ExampleElement extends HTMLElement {
static get observedAttributes() {
return ["data-state"];
}
attributeChangedCallback(name, oldValue, newValue, namespace) {
// React to an observed attribute.
}
connectedCallback() {
// Start work that requires a document connection.
}
disconnectedCallback() {
// Stop that work and release external resources.
}
}
customElements.define("example-element", ExampleElement);Triedu odvodenú od HTMLElement zaregistruj pomocou customElements.define(). Prehliadač potom sám volá metódy životného cyklu na jej inštanciách. Pri registrácii načíta statickú vlastnosť observedAttributes, ak je definovaná metóda attributeChangedCallback. Stačí statický getter, ktorý vráti pole názvov atribútov. Neskoršia úprava poľa nezmení zaregistrovaný zoznam.
attributeChangedCallback(name, oldValue, newValue, namespace) reaguje na pridanie, nastavenie alebo odobratie sledovaného atribútu, aj keď element nie je pripojený. name je lokálny názov atribútu a namespace je jeho menný priestor alebo null. Hodnoty atribútov sú reťazce: pri pridaní je oldValue rovné null, pri odobratí je newValue rovné null. Volanie môže vyvolať aj opätovné nastavenie rovnakej hodnoty. Keď prehliadač použije definíciu na už existujúci element (upgrade), reakcie na prítomné sledované atribúty zaradí do frontu pred prípadnou reakciou na pripojenie v rámci tohto upgradu.
connectedCallback() a disconnectedCallback() neprijímajú argumenty. Reagujú na pripojenie k dokumentu a odpojenie od neho, aj keď sa vkladá alebo odoberá predok elementu. Na tej istej inštancii sa môžu spustiť opakovane; bežný presun cez insertBefore() môže vyvolať obe metódy. Pri pripojení pridaj potrebné poslucháče udalostí alebo spusti časovače bez duplicít. Pri odpojení tieto poslucháče odober alebo časovače zastav.
Tieto mechanizmy patria do webovej platformy, nie do ECMAScript 2024. Používaj ich v prostredí s DOM a podporou Custom Elements.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Custom element lifecycle demo</title>
</head>
<body>
<script>
(() => {
const log = [];
const tag = "cktis-lifecycle-demo";
class LifecycleDemo extends HTMLElement {
static get observedAttributes() {
return ["data-state"];
}
attributeChangedCallback(name, oldValue, newValue) {
log.push(`${name}: ${JSON.stringify(oldValue)} -> ${JSON.stringify(newValue)}`);
}
connectedCallback() {
log.push("connected");
}
disconnectedCallback() {
log.push("disconnected");
}
}
customElements.define(tag, LifecycleDemo);
const element = document.createElement(tag);
element.setAttribute("data-state", "idle");
document.body.append(element);
element.setAttribute("data-state", "ready");
element.setAttribute("data-note", "not observed");
element.removeAttribute("data-state");
element.remove();
document.body.append(element);
element.remove();
console.log(log.join("\n"));
})();
</script>
</body>
</html>Výsledok
data-state: null -> "idle" connected data-state: "idle" -> "ready" data-state: "ready" -> null disconnected connected disconnected
V konzole prehliadača sa prvá zmena `data-state` zobrazí pred `connected` a `data-note` nevypíše žiadny riadok. Po odobratí `data-state` je nová hodnota `null` a po opätovnom vložení sa `connected` vypíše druhýkrát.
Súvisiace lekcie
- JavaScript · Lekcia 38 · Stredne pokročilá · Verzia: 3