Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Event.target i slušači u fazi hvatanja

Razlikuj cilj događaja od objekta na kojem je registriran slušač i provjeri kako opcija `capture` utječe na redoslijed poziva u DOM-u.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

event.target
 event.currentTarget
 event.eventPhase
 node.addEventListener(type, listener, { capture: true })
 node.addEventListener(type, listener, true)
 node.addEventListener(type, listener)

event.target označava cilj događaja iz perspektive slušača. event.currentTarget označava objekt na kojem je registriran slušač koji se trenutačno izvršava. Oba su svojstva samo za čitanje. Izvan poziva slušača currentTarget ima vrijednost null, pa spremi objekt tijekom poziva ako će ti zatrebati kasnije.

U običnom DOM stablu događaj najprije prolazi kroz pretke prema cilju. U toj se fazi (Event.CAPTURING_PHASE, 1) pozivaju slušači registrirani s { capture: true } ili s true kao trećim argumentom metode addEventListener(). Zadana vrijednost opcije capture jest false.

Na samom cilju slušači s hvatanjem izvršavaju se prije onih bez hvatanja, ali obje skupine čitaju istu vrijednost event.eventPhase: Event.AT_TARGET (2). Zatim, samo ako je event.bubbles jednak true, događaj se vraća kroz pretke obrnutim redoslijedom (Event.BUBBLING_PHASE, 3) i poziva njihove slušače bez hvatanja. Isključivanje širenja prema precima ne isključuje hvatanje ni obradu na cilju.

Ovi API-ji pripadaju DOM-u, a ne ECMAScriptu. U običnom stablu target se ne mijenja tijekom širenja, ali s druge strane granice Shadow DOM-a može označavati element domaćina umjesto unutarnjeg čvora.

Primjeri

(() => {
  // Node.js has no DOM tree. This fallback models only the propagation used here.
  class DemoNode {
    #parent = null;
    #listeners = [];

    append(child) {
      child.#parent = this;
    }

    addEventListener(type, listener, options) {
      const capture = options === true || options?.capture === true;
      this.#listeners.push({ type, listener, capture });
    }

    dispatchEvent(event) {
      const ancestors = [];
      for (let node = this.#parent; node !== null; node = node.#parent) {
        ancestors.push(node);
      }

      let currentTarget = null;
      let phase = Event.NONE;
      Object.defineProperties(event, {
        target: { configurable: true, get: () => this },
        currentTarget: { configurable: true, get: () => currentTarget },
        eventPhase: { configurable: true, get: () => phase }
      });

      const invoke = (node, nextPhase, capture) => {
        currentTarget = node;
        phase = nextPhase;
        for (const entry of node.#listeners.slice()) {
          if (entry.type === event.type && entry.capture === capture) {
            entry.listener.call(node, event);
          }
        }
      };

      try {
        for (let i = ancestors.length - 1; i >= 0; i--) {
          invoke(ancestors[i], Event.CAPTURING_PHASE, true);
        }
        invoke(this, Event.AT_TARGET, true);
        invoke(this, Event.AT_TARGET, false);
        if (event.bubbles) {
          for (const node of ancestors) {
            invoke(node, Event.BUBBLING_PHASE, false);
          }
        }
      } finally {
        currentTarget = null;
        phase = Event.NONE;
      }
      return !event.defaultPrevented;
    }
  }

  const createElement = (tag) =>
    typeof document === 'undefined' ? new DemoNode() : document.createElement(tag);
  const parent = createElement('div');
  const child = createElement('button');
  parent.id = 'parent';
  child.id = 'child';
  parent.append(child);

  const report = (label) => (event) => {
    console.log(`${label}: target=${event.target.id}, currentTarget=${event.currentTarget.id}, phase=${event.eventPhase}`);
  };

  parent.addEventListener('demo', report('parent bubble'));
  child.addEventListener('demo', report('child non-capture'));
  parent.addEventListener('demo', report('parent capture'), { capture: true });
  child.addEventListener('demo', report('child capture'), { capture: true });

  child.dispatchEvent(new Event('demo', { bubbles: true }));
})();

Rezultat

parent capture: target=child, currentTarget=parent, phase=1
child capture: target=child, currentTarget=child, phase=2
child non-capture: target=child, currentTarget=child, phase=2
parent bubble: target=child, currentTarget=parent, phase=3

Pokreni kod u konzoli preglednika. Elementi se ne umeću u dokument, a `dispatchEvent()` sinkrono poziva slušače. U Node.js-u kod koristi pojednostavljeni model širenja događaja umjesto DOM-a preglednika. Uz `bubbles: false` nestaje samo posljednji redak.

Povezane lekcije

  • JavaScript · Lekcija 40 · Srednje · Verzija: 3

Izvori