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

CKTIS / JavaScript

Události DOMContentLoaded, hashchange, mouseover a focusin

Zvol správný cíl naslouchání pro připravenost DOM, změnu fragmentu URL, vstup ukazatele a získání fokusu. Události potomků můžeš obsloužit ve společném kontejneru.

Verze: Current web platform; runtime support varies

Syntaxe

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

Tyto čtyři události oznamují různé věci: připravenost dokumentu, navigaci podle fragmentu, pohyb ukazatele a změnu fokusu. Jde o rozhraní webové platformy. Údaj ECMAScript 2024 v poli verze označuje pouze verzi jazyka JavaScript a neříká, zda jsou tyto události podporovány. Ověř podporu v cílových prohlížečích: samotné prostředí JavaScriptu nezaručuje dostupnost DOM.

DOMContentLoaded poslouchej na document. Prohlížeč vyvolá tuto nezrušitelnou událost typu Event po dokončení analýzy HTML a spuštění klasických skriptů s defer i modulových skriptů bez async. Nečeká na obrázky ani skripty async; šablony stylů ji mohou nepřímo zpozdit blokováním skriptu. Pokud inicializaci stačí sestavený DOM, při document.readyState === "loading" zaregistruj posluchač s { once: true }, jinak inicializuj ihned. Stav "interactive" nedokazuje, že událost už nastala.

hashchange poslouchej na window, když navigace změní fragment URL v témže dokumentu, například přiřazením do location.hash. Událost HashChangeEvent obsahuje úplné adresy v oldURL a newURL. Volání history.pushState() ani history.replaceState() samo hashchange nevyvolá, i když se fragment změní.

mouseover je událost typu MouseEvent vyvolaná na prvku, na který ukazatel vstoupí. Probublává k předkům, takže i pohyb mezi potomky může spustit posluchač kontejneru. relatedTarget označuje prvek, který ukazatel opustil, nebo má hodnotu null, pokud vedlejší cíl neexistuje. Chceš-li zachytit jen vstup zvenčí do kontejneru, poslouchej přímo mouseenter, který neprobublává.

focusin je nezrušitelná událost typu FocusEvent vyvolaná při získání fokusu, například po stisku Tab. Na rozdíl od focus událost focusin probublává. Při delegování focusin nebo mouseover v běžném stromu DOM zjistíš dotčený prvek z event.target a kontejner, jehož posluchač právě běží, z event.currentTarget.

Příklady

(() => {
  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,
    };
  }
})();

Výsledek

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

Spusť kód v konzoli prohlížeče na stránce `about:blank` nebo ho ulož jako `main.js` a spusť příkazem `node main.js`. Prohlížeč používá svůj nativní DOM, zatímco v Node.js kód používá jen zjednodušený model stromu a událostí. `dispatchEvent()` vyvolává syntetické události synchronně: znovu nenačte dokument, nezmění URL a nepřesune ukazatel ani fokus. Poslední dva řádky ukazují probublávání z tlačítka ke kontejneru nepřipojenému k dokumentu.

Související lekce

  • JavaScript · Lekce 38 · Pokročilá · Verze: 4

Zdroje