Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

`disconnectedCallback()` elementu niestandardowego

Użyj `disconnectedCallback()`, aby zwolnić zasoby związane z obecnością elementu niestandardowego w dokumencie, i przygotuj element na ponowne dołączenie.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

class MyElement extends HTMLElement {
  disconnectedCallback() {
    // Release resources tied to the current connection.
  }
}
customElements.define("my-element", MyElement);

disconnectedCallback() to opcjonalna metoda cyklu życia instancji zarejestrowanego elementu niestandardowego. Przeglądarka wywołuje ją bez argumentów, z this wskazującym element, gdy element traci połączenie z dokumentem, na przykład wskutek usunięcia jego przodka. Samo ukrycie elementu lub utworzenie go bez wstawienia do dokumentu nie wywołuje tej metody. Należy ona do platformy webowej, a nie do ECMAScript 2024.

W connectedCallback() uruchamiaj pracę zależną od połączenia z dokumentem, a w disconnectedCallback() ją kończ: zatrzymuj timery, odłączaj obserwatory i usuwaj nasłuchiwanie na zewnętrznych obiektach. Przy removeEventListener() użyj tego samego obiektu docelowego, typu zdarzenia, obiektu funkcji i wartości capture co przy rejestracji. Odłączenie nie niszczy instancji: może ona zostać ponownie dołączona, więc sprzątanie powinno być bezpieczne także przy powtórzeniu.

Typowe przeniesienie elementu w obrębie dokumentu za pomocą Node.insertBefore() może wywołać disconnectedCallback(), a następnie connectedCallback(). Gdy przeglądarka obsługuje przenoszenie za pomocą Element.moveBefore() i element definiuje connectedMoveCallback(), przy takim przeniesieniu wywoływana jest ta metoda zamiast obu pozostałych. Sprawdź obsługę w docelowych przeglądarkach.

Przykłady

<!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>

Wynik

1, 1, 2, 2

Zapisz cały kod w pliku HTML i otwórz go w przeglądarce. To ta sama instancja przy obu dołączeniach. Licznik rośnie po zdarzeniu `ping` tylko wtedy, gdy element jest dołączony, więc oczekiwany wynik to `1, 1, 2, 2`.

Powiązane lekcje

  • JavaScript · Lekcja 39 · Średniozaawansowany · Wersja: 3

Źródła