Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

`disconnectedCallback()` vlastného prvku

Pomocou `disconnectedCallback()` uvoľnite prostriedky viazané na pripojenie vlastného prvku k dokumentu a pripravte ho na prípadné opätovné pripojenie.

Verzia: 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() je voliteľná inštančná metóda životného cyklu zaregistrovaného vlastného prvku. Prehliadač ju volá bez argumentov, pričom this odkazuje na prvok, keď prvok stratí spojenie s dokumentom, napríklad po odstránení jeho predka. Samotné skrytie prvku alebo jeho vytvorenie bez vloženia metódu nevyvolá. Metóda patrí k webovej platforme, nie k ECMAScriptu 2024.

Činnosti viazané na pripojenie začnite v connectedCallback() a ukončite v disconnectedCallback(): zastavte časovače, odpojte pozorovateľov a odstráňte poslucháče udalostí z externých cieľov. Pri removeEventListener() použite rovnaký cieľ, typ udalosti, objekt funkcie aj hodnotu capture ako pri registrácii. Odpojenie inštanciu nezničí a možno ju znova pripojiť, preto musí byť možné čistenie bezpečne zopakovať.

Bežný presun v rámci dokumentu pomocou Node.insertBefore() môže vyvolať disconnectedCallback() a potom connectedCallback(). Ak prehliadač podporuje Element.moveBefore() a prvok definuje connectedMoveCallback(), presun so zachovaním stavu pomocou tohto API zavolá túto metódu namiesto zvyšných dvoch. Overte podporu v cieľových prehliadačoch.

Prí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ýsledok

1, 1, 2, 2

Uložte celý kód do súboru HTML a otvorte ho v prehliadači. Pri oboch vloženiach sa používa rovnaká inštancia. Udalosť `ping` zvýši počítadlo iba vtedy, keď je prvok pripojený. Očakávaný výstup je `1, 1, 2, 2`.

Súvisiace lekcie

  • JavaScript · Lekcia 39 · Stredne pokročilá · Verzia: 3

Zdroje