Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Događaji `scroll` i `resize` te opcija `passive`

Odaberi pravu metu za događaje pomicanja i promjene veličine te saznaj kada pasivni slušatelj onemogućuje otkazivanje zadane radnje.

Verzija: Current web platform; runtime support varies

Sintaksa

// 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();

Za pomicanje stranice slušaj scroll na document, a za promjene unutar spremnika izravno na elementu koji se pomiče. scroll javlja promjenu položaja, bez obzira na to je li do nje došlo zbog korisnika ili zbog koda. wheel javlja unos koji ne mora dovesti do pomicanja. Promjenu veličine vidljivog područja prati pomoću resize na window; taj se događaj ne širi u uzlaznoj fazi. Za praćenje veličine elementa koristi ResizeObserver.

Proslijedi { passive: true } u objektu opcija kao treći argument metode addEventListener(); sama Booleova vrijednost na tom mjestu postavlja capture, a ne passive. U pasivnom slušatelju preventDefault() nema učinka i može proizvesti upozorenje. { passive: false } omogućuje otkazivanje zadane radnje samo kada je event.cancelable jednak true. Događaji scroll dokumenta ili elementa i resize prozora koje pokreće preglednik ne mogu se otkazati; opcija to ne mijenja.

Za unos poput wheel ili touchmove pasivni slušatelj omogućuje pregledniku da započne pomicanje bez čekanja da slušatelj završi. Ako izostaviš opciju, zadana vrijednost može ovisiti o događaju, meti i pregledniku. Postavi passive: true ako samo pratiš unos. Ako moraš otkazati radnju, postavi passive: false i provjeri event.cancelable.

passive ne smanjuje ni učestalost poziva ni zahtjevnost obrade. Neka obrada čestih događaja bude kratka; ako se zahtjevan posao mora obavljati rjeđe, ograniči njegovu učestalost vremenskim brojačem. requestAnimationFrame() pomaže uskladiti vizualna ažuriranja s kadrovima, ali sam ne jamči manju učestalost od scroll.

Za uklanjanje pozovi removeEventListener() na istoj meti, s istom vrstom događaja, istom funkcijom i istom vrijednošću capture; passive ne sudjeluje u provjeri podudaranja. Ti API-ji pripadaju web-platformi, a ne ECMAScriptu 2024. Provjeri podršku u ciljnom izvršnom okruženju.

Primjeri

{
  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}`);
  }
}

Rezultat

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

Pokreni kôd u konzoli preglednika. Sintetički događaji ne pomiču stranicu i ne mijenjaju veličinu prozora. Samo posljednji slučaj postavlja `defaultPrevented` na `true`: događaj se može otkazati, a slušatelj nije pasivan. Pokušaj otkazivanja u pasivnom slušatelju može proizvesti zasebno upozorenje.

Povezane lekcije

  • JavaScript · Lekcija 11 · Napredno · Verzija: 4

Izvori