База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Event.target и слушатели във фазата на прихващане

Разграничи целта на събитието от обекта, на който е регистриран слушателят, и виж как `capture` променя реда на извикванията в DOM.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

event.target показва целта на събитието така, както я вижда слушателят. event.currentTarget показва обекта, на който е регистриран изпълняваният в момента слушател. И двете свойства са само за четене. Извън извикването на слушателя currentTarget е null; запази обекта по време на извикването, ако ще ти трябва по-късно.

В обикновено DOM дърво събитието първо преминава през предшествениците по посока на целта. В тази фаза (Event.CAPTURING_PHASE, 1) се извикват слушателите, регистрирани с { capture: true } или с true като трети аргумент на addEventListener(). Стойността по подразбиране на capture е false.

На самата цел слушателите с прихващане се изпълняват преди тези без прихващане, но и двете групи четат една и съща стойност на event.eventPhase: Event.AT_TARGET (2). След това, само ако event.bubbles е true, събитието се връща през предшествениците в обратен ред (Event.BUBBLING_PHASE, 3) и извиква техните слушатели без прихващане. Изключването на разпространението нагоре не изключва прихващането или обработката на самата цел.

Тези API са част от DOM, а не от ECMAScript. В обикновено дърво target не се променя по време на разпространението, но от другата страна на граница на Shadow DOM може да сочи към елемента домакин вместо към вътрешния възел.

Примери

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

Резултат

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

Изпълни кода в конзолата на браузъра. Елементите не се добавят към документа, а `dispatchEvent()` извиква слушателите синхронно. В Node.js кодът използва опростен модел на разпространение на събития вместо DOM на браузъра. При `bubbles: false` отпада само последният ред.

Свързани уроци

  • JavaScript · Урок 40 · Средно · Версия: 3

Източници