Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Elementi po meri: opazovani atributi in življenjski cikel

Spoznaj, kako element po meri izbere atribute za opazovanje in se odzove na njihove spremembe ter na povezavo z dokumentom in odklop od njega.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

class ExampleElement extends HTMLElement {
  static get observedAttributes() {
    return ["data-state"];
  }

  attributeChangedCallback(name, oldValue, newValue, namespace) {
    // React to an observed attribute.
  }

  connectedCallback() {
    // Start work that requires a document connection.
  }

  disconnectedCallback() {
    // Stop that work and release external resources.
  }
}

customElements.define("example-element", ExampleElement);

Razred, ki razširja HTMLElement, registriraj z customElements.define(). Brskalnik nato sam kliče metode življenjskega cikla na primerkih razreda. Ob registraciji prebere statično lastnost observedAttributes, če je definirana metoda attributeChangedCallback. Zadošča statični getter, ki vrne polje imen atributov. Poznejša sprememba tega polja ne spremeni registriranega seznama.

attributeChangedCallback(name, oldValue, newValue, namespace) se odzove na dodajanje, nastavljanje ali odstranjevanje opazovanega atributa, tudi če element ni povezan z dokumentom. name je lokalno ime atributa, namespace pa njegov imenski prostor ali null. Vrednosti atributov so nizi: ob dodajanju je oldValue enak null, ob odstranitvi pa je newValue enak null. Tudi ponovna nastavitev iste vrednosti lahko sproži klic. Ko brskalnik uporabi definicijo za že obstoječi element (nadgradnja), postavi odzive za že prisotne opazovane atribute v čakalno vrsto pred morebitnim odzivom na povezavo pri tej nadgradnji.

connectedCallback() in disconnectedCallback() ne prejmeta argumentov. Odzoveta se na povezavo z dokumentom oziroma odklop od njega, tudi če je vstavljen ali odstranjen prednik elementa. Na istem primerku se lahko izvedeta večkrat; običajen premik z insertBefore() lahko sproži oba klica. Ob povezavi dodaj potrebne poslušalce dogodkov ali zaženi časovnike brez podvajanja. Ob odklopu te poslušalce odstrani ali časovnike ustavi.

Ti mehanizmi so del spletne platforme in ne ECMAScript 2024. Uporabi jih v okolju z DOM in podporo za Custom Elements.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Custom element lifecycle demo</title>
</head>
<body>
  <script>
    (() => {
      const log = [];
      const tag = "cktis-lifecycle-demo";

      class LifecycleDemo extends HTMLElement {
        static get observedAttributes() {
          return ["data-state"];
        }

        attributeChangedCallback(name, oldValue, newValue) {
          log.push(`${name}: ${JSON.stringify(oldValue)} -> ${JSON.stringify(newValue)}`);
        }

        connectedCallback() {
          log.push("connected");
        }

        disconnectedCallback() {
          log.push("disconnected");
        }
      }

      customElements.define(tag, LifecycleDemo);
      const element = document.createElement(tag);
      element.setAttribute("data-state", "idle");
      document.body.append(element);
      element.setAttribute("data-state", "ready");
      element.setAttribute("data-note", "not observed");
      element.removeAttribute("data-state");
      element.remove();
      document.body.append(element);
      element.remove();

      console.log(log.join("\n"));
    })();
  </script>
</body>
</html>

Rezultat

data-state: null -> "idle"
connected
data-state: "idle" -> "ready"
data-state: "ready" -> null
disconnected
connected
disconnected

V konzoli brskalnika se prva sprememba `data-state` izpiše pred `connected`, za `data-note` pa ni izpisa. Po odstranitvi `data-state` je nova vrednost `null`; ob ponovni vstavitvi se `connected` izpiše drugič.

Povezane lekcije

  • JavaScript · Lekcija 38 · Srednja · Različica: 3

Viri