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

CKTIS / JavaScript

Event.target in poslušalci v fazi zajemanja

Loči cilj dogodka od predmeta, na katerem je registriran poslušalec, in preveri, kako možnost `capture` vpliva na vrstni red klicev v DOM-u.

Različica: 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čuje cilj dogodka, kot ga vidi poslušalec. event.currentTarget označuje predmet, na katerem je registriran trenutno izvajani poslušalec. Obe lastnosti sta samo za branje. Zunaj klica poslušalca ima currentTarget vrednost null, zato predmet shrani med klicem, če ga potrebuješ pozneje.

V običajnem drevesu DOM dogodek najprej potuje prek prednikov proti cilju. V tej fazi (Event.CAPTURING_PHASE, 1) se pokličejo poslušalci, registrirani z { capture: true } ali s true kot tretjim argumentom addEventListener(). Privzeta vrednost capture je false.

Na samem cilju se poslušalci z zajemanjem izvedejo pred poslušalci brez zajemanja, vendar obe skupini prebereta isto vrednost event.eventPhase: Event.AT_TARGET (2). Nato se dogodek samo, če je event.bubbles enak true, vrača prek prednikov v obratnem vrstnem redu (Event.BUBBLING_PHASE, 3) in kliče njihove poslušalce brez zajemanja. Izklop širjenja navzgor ne izklopi zajemanja niti obravnave na cilju.

Ti vmesniki API so del DOM-a, ne ECMAScripta. V običajnem drevesu se target med širjenjem ne spremeni, vendar lahko na drugi strani meje senčnega DOM-a kaže na gostiteljski element namesto na notranje vozlišče.

Primeri

(() => {
  // 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

Zaženi kodo v konzoli brskalnika. Elementa se ne vstavita v dokument, `dispatchEvent()` pa poslušalce pokliče sinhrono. V Node.js koda namesto DOM-a brskalnika uporabi poenostavljen model širjenja dogodkov. Z `bubbles: false` izgine samo zadnja vrstica.

Povezane lekcije

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

Viri