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

CKTIS / JavaScript

Dogodki DOMContentLoaded, hashchange, mouseover in focusin

Izberi pravo tarčo za poslušanje pripravljenosti DOM-a, spremembe fragmenta URL-ja, vstopa kazalca in pridobitve fokusa. Dogodke potomcev prestrezi v skupnem vsebniku.

Različica: Current web platform; runtime support varies

Sintaksa

document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("hashchange", onHashChange);
container.addEventListener("mouseover", onMouseOver);
container.addEventListener("focusin", onFocusIn);

Ti štirje dogodki sporočajo različne stvari: pripravljenost dokumenta, krmarjenje po fragmentih, premikanje kazalca in spremembo fokusa. So del spletne platforme. Oznaka ECMAScript 2024 v polju za različico se nanaša samo na jezik JavaScript in ne pove, ali so ti dogodki podprti. Preveri podporo v ciljnih brskalnikih: samo okolje JavaScript ne zagotavlja dostopa do DOM-a.

DOMContentLoaded poslušaj na document. Brskalnik sproži ta nepreklicni Event, ko razčleni HTML ter izvede klasične skripte z defer in modulske skripte brez async. Ne čaka na slike ali skripte z async; slogovne predloge ga lahko posredno zakasnijo, če blokirajo skript. Če inicializacija potrebuje le razčlenjeni DOM, pri document.readyState === "loading" nastavi poslušalca z { once: true }, sicer inicializacijo izvedi takoj. Stanje "interactive" ne dokazuje, da se je dogodek že sprožil.

hashchange poslušaj na window, ko krmarjenje spremeni fragment URL-ja v istem dokumentu, na primer s prireditvijo vrednosti location.hash. HashChangeEvent vsebuje celotna URL-ja v oldURL in newURL. Klica history.pushState() in history.replaceState() sama ne sprožita hashchange, tudi če se fragment spremeni.

mouseover je MouseEvent, sprožen na elementu, v katerega vstopi kazalec. Dogodek se širi navzgor do prednikov, zato lahko premik med potomci sproži tudi poslušalca vsebnika. relatedTarget označuje element, ki ga je kazalec zapustil, ali pa ima vrednost null, če ni druge tarče. Če želiš zaznati le vstop v vsebnik od zunaj, poslušaj neposredno mouseenter, ki se ne širi navzgor.

focusin je nepreklicni FocusEvent, sprožen, ko element pridobi fokus, na primer ob pritisku tipke Tab. Za razliko od focus se focusin širi navzgor. Pri delegiranju focusin ali mouseover v običajnem drevesu DOM uporabi event.target za določitev obravnavanega elementa in event.currentTarget za določitev vsebnika, katerega poslušalec se izvaja.

Primeri

(() => {
  const { document, window, HashChangeEvent, MouseEvent, FocusEvent } =
    typeof globalThis.document === "undefined" ? createNodeDemo() : globalThis;

  const container = document.createElement("div");
  const button = document.createElement("button");
  container.append(button);

  document.addEventListener("DOMContentLoaded", (event) => {
    console.log(`${event.type}: document=${event.target === document}`);
  }, { once: true });

  window.addEventListener("hashchange", (event) => {
    console.log(`${event.type}: ${new URL(event.oldURL).hash} -> ${new URL(event.newURL).hash}`);
  }, { once: true });

  for (const type of ["mouseover", "focusin"]) {
    container.addEventListener(type, (event) => {
      console.log(`${event.type}: button=${event.target === button}, container=${event.currentTarget === container}`);
    });
  }

  document.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
  window.dispatchEvent(new HashChangeEvent("hashchange", {
    oldURL: "https://example.com/#before",
    newURL: "https://example.com/#after",
  }));
  button.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
  button.dispatchEvent(new FocusEvent("focusin", { bubbles: true }));

  // Node.js fallback: model only the detached tree and event data used here.
  function createNodeDemo() {
    class DemoElement extends EventTarget {
      parentNode = null;

      append(child) {
        child.parentNode = this;
      }

      dispatchEvent(event) {
        let current = this;
        Object.defineProperties(event, {
          target: { configurable: true, value: this },
          currentTarget: { configurable: true, get: () => current },
        });

        try {
          for (; current; current = current.parentNode) {
            EventTarget.prototype.dispatchEvent.call(current, event);
            if (!event.bubbles || event.cancelBubble) break;
          }
        } finally {
          current = null;
        }
        return !event.defaultPrevented;
      }
    }

    class DemoHashChangeEvent extends Event {
      constructor(type, { oldURL, newURL }) {
        super(type);
        this.oldURL = oldURL;
        this.newURL = newURL;
      }
    }

    return {
      document: Object.assign(new EventTarget(), {
        createElement: () => new DemoElement(),
      }),
      window: new EventTarget(),
      HashChangeEvent: DemoHashChangeEvent,
      MouseEvent: Event,
      FocusEvent: Event,
    };
  }
})();

Rezultat

DOMContentLoaded: document=true
hashchange: #before -> #after
mouseover: button=true, container=true
focusin: button=true, container=true

Zaženi kodo v konzoli brskalnika na `about:blank` ali jo shrani kot `main.js` in zaženi `node main.js`. Brskalnik uporabi svoj DOM, v okolju Node.js pa koda namesto DOM-a uporabi poenostavljen model drevesa in dogodkov. `dispatchEvent()` sinhrono sproži sintetične dogodke: ne naloži dokumenta znova, ne spremeni URL-ja in ne premakne kazalca ali fokusa. Zadnji dve vrstici prikažeta širjenje dogodka z gumba na vsebnik, ki ni povezan z dokumentom.

Povezane lekcije

  • JavaScript · Lekcija 38 · Napredna · Različica: 4

Viri