CKTIS / JavaScript
`disconnectedCallback()` van een aangepast element
Gebruik `disconnectedCallback()` om bronnen vrij te geven die gekoppeld zijn aan de verbinding met een document, zodat het aangepaste element later opnieuw kan worden aangesloten.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
class MyElement extends HTMLElement {
disconnectedCallback() {
// Release resources tied to the current connection.
}
}
customElements.define("my-element", MyElement);disconnectedCallback() is een optionele levenscyclusmethode op de instantie van een geregistreerd aangepast element. De browser roept de methode aan zonder argumenten en met het element als this zodra het zijn verbinding met een document verliest, bijvoorbeeld doordat een voorouderelement wordt verwijderd. Alleen verbergen of aanmaken zonder invoegen activeert de methode niet. Ze behoort tot het webplatform, niet tot ECMAScript 2024.
Start werk dat afhankelijk is van de verbinding in connectedCallback() en beëindig het in disconnectedCallback(): stop timers, ontkoppel observers en verwijder gebeurtenislisteners van externe doelen. Gebruik bij removeEventListener() hetzelfde doel, gebeurtenistype, functieobject en dezelfde capture-waarde als bij de registratie. De instantie wordt niet vernietigd en kan opnieuw worden verbonden. Zorg daarom dat herhaald opruimen geen problemen geeft.
Een gewone verplaatsing binnen een document met Node.insertBefore() kan eerst disconnectedCallback() en daarna connectedCallback() activeren. Als de browser Element.moveBefore() ondersteunt en het element connectedMoveCallback() definieert, roept een verplaatsing met behoud van toestand via die API deze laatste methode aan in plaats van de andere twee. Controleer de ondersteuning in de doelbrowsers.
Voorbeelden
<!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>Resultaat
1, 1, 2, 2
Sla de volledige code op als HTML-bestand en open het in een browser. Beide invoegingen gebruiken dezelfde instantie. Een `ping` verhoogt de teller alleen als het element verbonden is. De verwachte uitvoer is `1, 1, 2, 2`.
Gerelateerde lessen
- JavaScript · Les 39 · Gemiddeld · Versie: 3