CKTIS / JavaScript
Събитията DOMContentLoaded, hashchange, mouseover и focusin
Избери къде да слушаш за готов DOM, промяна на фрагмента на URL, навлизане на показалеца и получаване на фокус. Делегирай обработката на събития от потомци на общ контейнер.
Версия: Current web platform; runtime support varies
Синтаксис
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("hashchange", onHashChange);
container.addEventListener("mouseover", onMouseOver);
container.addEventListener("focusin", onFocusIn);Тези четири събития сигнализират за различни неща: готовност на документа, навигация по фрагменти, движение на показалеца и промяна на фокуса. Те са интерфейси на уеб платформата. В полето за версия ECMAScript 2024 се отнася само до езика JavaScript и не указва дали тези събития се поддържат. Провери поддръжката в целевите браузъри: самата среда за JavaScript не гарантира наличието на DOM.
Слушай за DOMContentLoaded върху document. Браузърът задейства това неотменимо събитие от тип Event, след като анализира HTML и изпълни класическите скриптове с defer и модулните скриптове без async. Не изчаква изображения или скриптове с async; таблиците със стилове могат косвено да забавят събитието, ако блокират скрипт. Ако за инициализацията е нужен само изграденият DOM, регистрирай слушател с { once: true }, когато document.readyState === "loading"; иначе инициализирай веднага. Състоянието "interactive" не доказва, че събитието вече е настъпило.
Слушай за hashchange върху window, когато навигация промени фрагмента на URL в същия документ, например чрез присвояване на стойност на location.hash. В HashChangeEvent свойствата oldURL и newURL съдържат пълните адреси. Извикването на history.pushState() или history.replaceState() само по себе си не задейства hashchange, дори ако фрагментът се промени.
mouseover е събитие от тип MouseEvent, което се задейства върху елемента, в който навлиза показалецът. То се разпространява нагоре към предците, затова движение между потомци също може да активира слушателя на контейнера. relatedTarget посочва напуснатия елемент или има стойност null, ако няма вторична цел. За да засечеш само навлизане отвън в контейнера, слушай директно за mouseenter, което не се разпространява нагоре.
focusin е неотменимо събитие от тип FocusEvent, което се задейства, когато елемент получи фокус, например при натискане на Tab. За разлика от focus, focusin се разпространява нагоре. При делегиране на focusin или mouseover в обикновено DOM дърво event.target посочва засегнатия елемент, а event.currentTarget — контейнера, чийто слушател се изпълнява.
Примери
(() => {
const { document, window, HashChangeEvent, MouseEvent, FocusEvent } =
typeof globalThis.document === "undefined" ? createNodeDemo() : globalThis;
const container = document.createElement("div");
const button = document.createElement("button");
container.append(button);
document.addEventListener("DOMContentLoaded", (event) => {
console.log(`${event.type}: document=${event.target === document}`);
}, { once: true });
window.addEventListener("hashchange", (event) => {
console.log(`${event.type}: ${new URL(event.oldURL).hash} -> ${new URL(event.newURL).hash}`);
}, { once: true });
for (const type of ["mouseover", "focusin"]) {
container.addEventListener(type, (event) => {
console.log(`${event.type}: button=${event.target === button}, container=${event.currentTarget === container}`);
});
}
document.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
window.dispatchEvent(new HashChangeEvent("hashchange", {
oldURL: "https://example.com/#before",
newURL: "https://example.com/#after",
}));
button.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
button.dispatchEvent(new FocusEvent("focusin", { bubbles: true }));
// Node.js fallback: model only the detached tree and event data used here.
function createNodeDemo() {
class DemoElement extends EventTarget {
parentNode = null;
append(child) {
child.parentNode = this;
}
dispatchEvent(event) {
let current = this;
Object.defineProperties(event, {
target: { configurable: true, value: this },
currentTarget: { configurable: true, get: () => current },
});
try {
for (; current; current = current.parentNode) {
EventTarget.prototype.dispatchEvent.call(current, event);
if (!event.bubbles || event.cancelBubble) break;
}
} finally {
current = null;
}
return !event.defaultPrevented;
}
}
class DemoHashChangeEvent extends Event {
constructor(type, { oldURL, newURL }) {
super(type);
this.oldURL = oldURL;
this.newURL = newURL;
}
}
return {
document: Object.assign(new EventTarget(), {
createElement: () => new DemoElement(),
}),
window: new EventTarget(),
HashChangeEvent: DemoHashChangeEvent,
MouseEvent: Event,
FocusEvent: Event,
};
}
})();Резултат
DOMContentLoaded: document=true hashchange: #before -> #after mouseover: button=true, container=true focusin: button=true, container=true
Изпълни кода в конзолата на браузъра на `about:blank` или го запази като `main.js` и изпълни `node main.js`. Браузърът използва собствения си DOM, а в Node.js кодът използва опростен модел на дървото и събитията вместо DOM. `dispatchEvent()` задейства синтетични събития синхронно: не презарежда документа, не променя URL и не премества показалеца или фокуса. Последните два реда показват разпространението от бутона нагоре до контейнер, който не е свързан с документа.
Свързани уроци
- JavaScript · Урок 38 · Напреднало · Версия: 4
Източници
- HTML Standard — The end
- Document: DOMContentLoaded event
- Window: hashchange event
- HTML Standard — The HashChangeEvent interface
- Element: mouseover event
- Element: mouseenter event
- MouseEvent: relatedTarget property
- Element: focusin event
- Element: focus event
- EventTarget: addEventListener() method
- EventTarget: dispatchEvent() method