CKTIS / JavaScript
`disconnectedCallback()` vlastního prvku
Pomocí `disconnectedCallback()` uvolněte prostředky vázané na připojení vlastního prvku k dokumentu a připravte jej na případné opětovné připojení.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
class MyElement extends HTMLElement {
disconnectedCallback() {
// Release resources tied to the current connection.
}
}
customElements.define("my-element", MyElement);disconnectedCallback() je volitelná instanční metoda životního cyklu registrovaného vlastního prvku. Prohlížeč ji volá bez argumentů, přičemž this odkazuje na prvek, když prvek ztratí spojení s dokumentem, například při odebrání předka. Pouhé skrytí prvku nebo jeho vytvoření bez vložení metodu nevyvolá. Metoda patří k webové platformě, ne k ECMAScriptu 2024.
Činnosti vázané na připojení zahajte v connectedCallback() a ukončete v disconnectedCallback(): zastavte časovače, odpojte pozorovatele a odeberte posluchače událostí z externích cílů. Při removeEventListener() použijte stejný cíl, typ události, objekt funkce i hodnotu capture jako při registraci. Odpojení instanci nezničí a lze ji znovu připojit, proto musí být možné úklid bezpečně zopakovat.
Běžný přesun v rámci dokumentu pomocí Node.insertBefore() může vyvolat disconnectedCallback() a poté connectedCallback(). Pokud prohlížeč podporuje Element.moveBefore() a prvek definuje connectedMoveCallback(), přesun se zachováním stavu pomocí tohoto API vyvolá tuto metodu namísto zbývajících dvou. Ověřte podporu v cílových prohlížečích.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Custom element disconnection</title>
</head>
<body>
<pre id="result"></pre>
<script>
const source = new EventTarget();
let count = 0;
class CktisPingCounter extends HTMLElement {
#onPing = () => { count += 1; };
connectedCallback() {
source.addEventListener("ping", this.#onPing);
}
disconnectedCallback() {
source.removeEventListener("ping", this.#onPing);
}
}
customElements.define("cktis-ping-counter", CktisPingCounter);
const counter = document.createElement("cktis-ping-counter");
const counts = [];
const probe = () => {
source.dispatchEvent(new Event("ping"));
counts.push(count);
};
document.body.append(counter);
probe();
counter.remove();
probe();
document.body.append(counter);
probe();
counter.remove();
probe();
const output = counts.join(", ");
document.getElementById("result").textContent = output;
console.log(output);
</script>
</body>
</html>Výsledek
1, 1, 2, 2
Uložte celý kód do souboru HTML a otevřete jej v prohlížeči. Při obou vloženích se používá stejná instance. Událost `ping` zvýší hodnotu počitadla pouze tehdy, když je prvek připojený. Očekávaný výstup je `1, 1, 2, 2`.
Související lekce
- JavaScript · Lekce 39 · Středně pokročilá · Verze: 3