CKTIS / JavaScript
Udalosti `scroll` a `resize` a voľba `passive`
Vyber správny cieľ pre sledovanie posúvania alebo zmeny veľkosti a zisti, kedy pasívny poslucháč bráni zrušeniu predvolenej akcie.
Verzia: Current web platform; runtime support varies
Syntax
// 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();Na sledovanie posúvania stránky počúvaj scroll na document, pri zmenách v kontajneri priamo na posúvanom prvku. scroll oznamuje zmenu polohy posunu bez ohľadu na to, či ju vyvolal používateľ alebo kód. wheel oznamuje vstup, ktorý nemusí viesť k posunu. Zmeny veľkosti zobrazovanej oblasti sleduj pomocou resize na window; táto udalosť sa nešíri vo fáze bublania. Na sledovanie veľkosti prvku použi ResizeObserver.
Odovzdaj { passive: true } v objekte možností ako tretí argument addEventListener(); samotná logická hodnota na tomto mieste nastavuje capture, nie passive. V pasívnom poslucháčovi nemá preventDefault() účinok a môže vyvolať upozornenie. { passive: false } umožňuje zrušiť predvolenú akciu iba vtedy, keď je event.cancelable rovné true. Udalosti scroll dokumentu alebo prvku a resize okna, ktoré vyvolá prehliadač, sa nedajú zrušiť; voľba na tom nič nemení.
Pri vstupoch ako wheel alebo touchmove môže prehliadač s pasívnym poslucháčom začať posúvať obsah, kým poslucháč ešte pracuje. Ak voľbu vynecháš, predvolená hodnota môže závisieť od udalosti, cieľa a prehliadača. Nastav passive: true, ak vstup len sleduješ. Ak potrebuješ zrušiť akciu, nastav passive: false a skontroluj event.cancelable.
passive neznižuje frekvenciu volaní ani náročnosť práce. Obsluhu častých udalostí udržuj krátku; ak treba náročné operácie vykonávať menej často, obmedz ich frekvenciu časovačom. requestAnimationFrame() pomáha zosúladiť vizuálne aktualizácie so snímkami, ale sám nezaručuje nižšiu frekvenciu než scroll.
Pri upratovaní zavolaj removeEventListener() na rovnakom cieli s rovnakým typom, rovnakou funkciou a rovnakou hodnotou capture; passive pri hľadaní zhody nerozhoduje. Tieto API patria do webovej platformy, nie do ECMAScript 2024. Over podporu v cieľovom prostredí.
Prí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ýsledok
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 konzole prehliadača. Syntetické udalosti neposúvajú stránku ani nemenia veľkosť okna. Iba posledný prípad nastaví `defaultPrevented` na `true`: udalosť sa dá zrušiť a poslucháč nie je pasívny. Pokus o zrušenie v pasívnom poslucháčovi môže vyvolať samostatné upozornenie.
Súvisiace lekcie
- JavaScript · Lekcia 11 · Pokročilá · Verzia: 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