CKTIS / JavaScript
Потребителски елементи: наблюдавани атрибути и жизнен цикъл
Научи как потребителски елемент избира кои атрибути да наблюдава и как реагира на техните промени, свързването с документ и отделянето от него.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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);Регистрирай клас, който наследява HTMLElement, чрез customElements.define(). След това браузърът сам извиква методите от жизнения цикъл на екземплярите. При регистрацията той прочита статичното свойство observedAttributes, ако е дефиниран attributeChangedCallback. Достатъчен е статичен getter, който връща масив с имена на атрибути. Промяната на масива по-късно не променя регистрирания списък.
attributeChangedCallback(name, oldValue, newValue, namespace) реагира при добавяне, задаване или премахване на наблюдаван атрибут дори когато елементът е отделен от документа. name е локалното име на атрибута, а namespace е неговото пространство от имена или null. Стойностите на атрибутите са низове: при добавяне oldValue е null, а при премахване newValue е null. Повторното задаване на същата стойност също може да предизвика извикване. Когато браузърът приложи дефиницията към вече съществуващ елемент (надграждане), реакциите за наличните наблюдавани атрибути се нареждат на опашката преди евентуалната реакция при свързване за това надграждане.
connectedCallback() и disconnectedCallback() не получават аргументи. Те реагират съответно на свързване с документ и отделяне от него, включително когато се вмъква или премахва предшественик на елемента. Могат да се изпълнят многократно за един и същ екземпляр; обикновено преместване чрез insertBefore() може да задейства и двата метода. При свързване добавяй нужните слушатели за събития или стартирай таймери, без да ги дублираш. При отделяне премахвай тези слушатели или спирай таймерите.
Тези механизми са част от уеб платформата, а не от ECMAScript 2024. Използвай ги в среда с DOM и поддръжка на Custom Elements.
Примери
<!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>Резултат
data-state: null -> "idle" connected data-state: "idle" -> "ready" data-state: "ready" -> null disconnected connected disconnected
В конзолата на браузъра първата промяна на `data-state` се появява преди `connected`, а за `data-note` няма ред. При премахване на `data-state` новата стойност е `null`, а повторното вмъкване задейства `connected` втори път.
Свързани уроци
- JavaScript · Урок 38 · Средно · Версия: 3