CKTIS / JavaScript
Události `scroll` a `resize` a volba `passive`
Vyber správný cíl pro sledování posunu nebo změny velikosti a zjisti, kdy pasivní posluchač brání zrušení výchozí akce.
Verze: Current web platform; runtime support varies
Syntaxe
// ECMAScript 2024 identifies the JavaScript language reference, not the version of these browser APIs.
// The DOM Standard defines the passive listener option, CSSOM View defines scroll and resize,
// and the Resize Observer specification defines ResizeObserver.
document.addEventListener("scroll", onPageScroll);
scrollContainer.addEventListener("scroll", onElementScroll);
window.addEventListener("resize", onViewportResize);
scrollContainer.addEventListener("wheel", onWheel, { passive: true });
scrollContainer.removeEventListener("wheel", onWheel);
const observer = new ResizeObserver(onElementResize);
observer.observe(element);
// When observation is no longer needed:
observer.disconnect();Pro posun stránky poslouchej scroll na document, pro změny uvnitř kontejneru přímo na posouvaném prvku. scroll oznamuje změnu polohy posunu bez ohledu na to, zda ji vyvolal uživatel, nebo kód. wheel oznamuje vstup, který nemusí vést k posunu. Změny velikosti viditelné oblasti sleduj pomocí resize na window; tato událost se nešíří ve fázi bublání. Velikost prvku sleduj pomocí ResizeObserver.
Předej { passive: true } v objektu voleb jako třetí argument addEventListener(); samotná logická hodnota na téže pozici nastavuje capture, nikoli passive. V pasivním posluchači nemá preventDefault() účinek a může vyvolat varování. { passive: false } dovoluje zrušit výchozí akci jen tehdy, když je event.cancelable rovno true. Události scroll dokumentu či prvku a resize okna, které vyvolá prohlížeč, nelze zrušit; volba na tom nic nemění.
U vstupů jako wheel nebo touchmove může prohlížeč s pasivním posluchačem zahájit posun, aniž by čekal na jeho dokončení. Když volbu vynecháš, výchozí hodnota může záviset na události, cíli a prohlížeči. Nastav passive: true, pokud vstup jen sleduješ. Potřebuješ-li zrušit akci, nastav passive: false a zkontroluj event.cancelable.
passive nesnižuje četnost volání ani náročnost vykonávané práce. U často vyvolávaných událostí udržuj obsluhu krátkou; pokud má náročná práce probíhat méně často, omez její četnost časovačem. requestAnimationFrame() pomáhá sladit vizuální aktualizace se snímky, ale sám nezaručuje nižší četnost než scroll.
Při úklidu zavolej removeEventListener() na stejném cíli se stejným typem, stejnou funkcí a stejnou hodnotou capture; passive se při hledání shody nebere v úvahu. Tato API patří do webové platformy, nikoli do ECMAScript 2024. Ověř podporu v cílovém běhovém prostředí.
Příklady
{
const cases = [
["scroll", false, false],
["resize", false, false],
["wheel", true, true],
["wheel", true, false],
];
for (const [type, cancelable, passive] of cases) {
const target = new EventTarget();
target.addEventListener(type, (event) => event.preventDefault(), { passive });
const event = new Event(type, { cancelable });
target.dispatchEvent(event);
console.log(`${type} cancelable=${event.cancelable} passive=${passive} defaultPrevented=${event.defaultPrevented}`);
}
}Výsledek
scroll cancelable=false passive=false defaultPrevented=false resize cancelable=false passive=false defaultPrevented=false wheel cancelable=true passive=true defaultPrevented=false wheel cancelable=true passive=false defaultPrevented=true
Spusť kód v konzoli prohlížeče. Syntetické události neposunou stránku ani nezmění velikost okna. Jen poslední případ nastaví `defaultPrevented` na `true`: událost lze zrušit a posluchač není pasivní. Pokus o zrušení v pasivním posluchači může vyvolat zvláštní varování.
Související lekce
- JavaScript · Lekce 11 · Pokročilá · Verze: 4
Zdroje
- Document: scroll event
- Element: scroll event
- Window: resize event
- ResizeObserver
- EventTarget: addEventListener() method
- EventTarget: removeEventListener() method
- Event: preventDefault() method
- Element: wheel event
- Event: Event() constructor
- EventTarget: dispatchEvent() method
- HTML Standard: Processing model
- ECMAScript 2024 Language Specification: Hosts and Implementations