Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje