Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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