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