CKTIS / JavaScript
Elementi po meri: opazovani atributi in življenjski cikel
Spoznaj, kako element po meri izbere atribute za opazovanje in se odzove na njihove spremembe ter na povezavo z dokumentom in odklop od njega.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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);Razred, ki razširja HTMLElement, registriraj z customElements.define(). Brskalnik nato sam kliče metode življenjskega cikla na primerkih razreda. Ob registraciji prebere statično lastnost observedAttributes, če je definirana metoda attributeChangedCallback. Zadošča statični getter, ki vrne polje imen atributov. Poznejša sprememba tega polja ne spremeni registriranega seznama.
attributeChangedCallback(name, oldValue, newValue, namespace) se odzove na dodajanje, nastavljanje ali odstranjevanje opazovanega atributa, tudi če element ni povezan z dokumentom. name je lokalno ime atributa, namespace pa njegov imenski prostor ali null. Vrednosti atributov so nizi: ob dodajanju je oldValue enak null, ob odstranitvi pa je newValue enak null. Tudi ponovna nastavitev iste vrednosti lahko sproži klic. Ko brskalnik uporabi definicijo za že obstoječi element (nadgradnja), postavi odzive za že prisotne opazovane atribute v čakalno vrsto pred morebitnim odzivom na povezavo pri tej nadgradnji.
connectedCallback() in disconnectedCallback() ne prejmeta argumentov. Odzoveta se na povezavo z dokumentom oziroma odklop od njega, tudi če je vstavljen ali odstranjen prednik elementa. Na istem primerku se lahko izvedeta večkrat; običajen premik z insertBefore() lahko sproži oba klica. Ob povezavi dodaj potrebne poslušalce dogodkov ali zaženi časovnike brez podvajanja. Ob odklopu te poslušalce odstrani ali časovnike ustavi.
Ti mehanizmi so del spletne platforme in ne ECMAScript 2024. Uporabi jih v okolju z DOM in podporo za Custom Elements.
Primeri
<!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>Rezultat
data-state: null -> "idle" connected data-state: "idle" -> "ready" data-state: "ready" -> null disconnected connected disconnected
V konzoli brskalnika se prva sprememba `data-state` izpiše pred `connected`, za `data-note` pa ni izpisa. Po odstranitvi `data-state` je nova vrednost `null`; ob ponovni vstavitvi se `connected` izpiše drugič.
Povezane lekcije
- JavaScript · Lekcija 38 · Srednja · Različica: 3