CKTIS / JavaScript
Събития в браузъра и тяхното разпространение
Събитията позволяват на кода да реагира на действия на потребителя и промени в състоянието на страницата. Научи за прихващането, целта и изплуването, различавай отмяната на стандартното действие от спирането на разпространението и опознай събитията за жизнен цикъл, видимост, превъртане, размер и въвеждане.
Версия: Web APIs defined by web standards, not ECMAScript editions. Check support in target browsers; Node 24 in the repository does not establish browser API support.
Синтаксис
target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);Модел и обхват
Браузърните събития са част от API на изпълняващата среда, а не от синтаксиса на ECMAScript. Стандартът DOM определя модела на събитията, изпращането и разпространението им и опциите на слушателите. Стандартът HTML определя, наред с другото, кога възникват DOMContentLoaded и load и кога се задействат input и change при елементите на формуляр. Не обвързвай тези API с издание на ECMAScript. Node 24 не доказва поддръжка на браузърни API. Провери съвместимостта в целевите браузъри.
Разпространение и отмяна
addEventListener(type, handler, options) регистрира обработчик. След прихващане при предците идва целта, а ако bubbles е истина, има и изплуване при предците. target е целта, currentTarget — обектът на активния слушател. stopPropagation() спира по-нататъшното разпространение, но не пропуска останалите слушатели от текущата поредица от извиквания. Ако обаче слушател за прихващане на целта извика stopPropagation(), отделната поредица от извиквания на слушателите без прихващане на същата цел не се изпълнява. stopImmediatePropagation() пропуска и останалите слушатели от текущата поредица. preventDefault() отменя стандартното действие само при отменимо събитие извън пасивен слушател. Не спира разпространението.
Жизнен цикъл и видимост
DOMContentLoaded на document означава край на анализа и на скриптовете, които го отлагат, не зареждане на всички ресурси. load на window чака и ресурсите, които го бавят. pageshow и pagehide обхващат преходите с кеша за назад/напред; провери persisted. При visibilitychange на document прочети document.visibilityState. Скрита не значи затворена; unload не гарантира финален запис.
Превъртане, размер и въвеждане
scroll засяга превъртаната цел, а resize на window — размера на видимата област. Не всички събития изплуват. Честите обработчици трябва да са леки. input означава редакция от потребителя, change — потвърждение според контролата. Задаване на .value не поражда нито едно. Различавай keydown, събития на указателя и семантичното click; не разчитай само на мишката.
Управление на слушателите
once премахва слушателя, преди обработчикът му да бъде извикан за първи път. Ако този обработчик синхронно изпрати друго събитие от същия тип, премахнатият слушател няма да го обработи. passive обезсилва preventDefault(), а signal позволява премахване чрез прекъсване. За removeEventListener запази типа, референцията към функцията и стойността на capture. В примера dispatchEvent() е синхронен: false означава отмяна, не спряно разпространение.
Референтни идентификатори, обхванати в тази статия: Page lifecycle, visibility, scroll/resize and input events.
Примери
(() => {
const parent = document.createElement('div');
const child = document.createElement('button');
parent.append(child);
const log = [];
parent.addEventListener('demo', () => log.push('capture'), { capture: true });
child.addEventListener('demo', event => {
log.push('target');
event.preventDefault();
});
parent.addEventListener('demo', () => log.push('bubble'));
const accepted = child.dispatchEvent(new Event('demo', {
bubbles: true,
cancelable: true
}));
console.log(log.join(' > '));
console.log(accepted);
})();Резултат
capture > target > bubble false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- DOM Standard — Events, dispatch, propagation, and listener options
- Official reference — developer.mozilla.org: API / PageTransitionEvent
- HTML Standard — End of parsing, DOMContentLoaded, and load
- MDN Web Docs — Document: visibilitychange event
- MDN Web Docs — Window: unload event
- CSSOM View Module — Scroll and resize event processing
- HTML Standard — Common input element events
- UI Events — Keyboard and click events
- Pointer Events