CKTIS / JavaScript
Prilagođeni elementi: praćeni atributi i životni ciklus
Nauči kako prilagođeni element odabire atribute za praćenje te reagira na njihove promjene, povezivanje s dokumentom i odvajanje od njega.
Verzija: 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);Klasu koja proširuje HTMLElement registriraj pomoću customElements.define(). Preglednik zatim sam poziva metode životnog ciklusa na instancama te klase. Pri registraciji čita statičko svojstvo observedAttributes ako je definiran attributeChangedCallback. Dovoljan je statički getter koji vraća polje naziva atributa. Naknadna izmjena polja ne mijenja registrirani popis.
attributeChangedCallback(name, oldValue, newValue, namespace) reagira na dodavanje, postavljanje ili uklanjanje praćenog atributa, čak i ako element nije povezan s dokumentom. name je lokalni naziv atributa, a namespace njegov imenski prostor ili null. Vrijednosti atributa su znakovni nizovi: pri dodavanju oldValue je null, a pri uklanjanju newValue je null. Ponovno postavljanje iste vrijednosti također može pokrenuti poziv. Kad preglednik primijeni definiciju na postojeći element (nadogradnja), reakcije za već prisutne praćene atribute stavlja u red prije moguće reakcije na povezivanje u sklopu te nadogradnje.
connectedCallback() i disconnectedCallback() ne primaju argumente. Reagiraju na povezivanje s dokumentom odnosno odvajanje od njega, čak i kad je umetnut ili uklonjen predak elementa. Mogu se izvršiti više puta na istoj instanci; obično premještanje pomoću insertBefore() može pokrenuti oba poziva. Pri povezivanju dodaj potrebne slušatelje događaja ili pokreni vremenske brojače bez dupliciranja. Pri odvajanju ukloni te slušatelje ili zaustavi te brojače.
Ti mehanizmi pripadaju web-platformi, a ne standardu ECMAScript 2024. Upotrebljavaj ih u okruženju s DOM-om i podrškom za Custom Elements.
Primjeri
<!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
U konzoli preglednika prva promjena atributa `data-state` ispisuje se prije `connected`, a za `data-note` nema ispisa. Uklanjanje atributa `data-state` daje `null` kao novu vrijednost, a ponovno umetanje pokreće `connected` drugi put.
Povezane lekcije
- JavaScript · Lekcija 38 · Srednje · Verzija: 3