Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Dogodka `scroll` in `resize` ter možnost `passive`

Izberi pravo tarčo za dogodke drsenja in spreminjanja velikosti ter ugotovi, kdaj pasivni poslušalec onemogoči preklic privzetega dejanja.

Različica: 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 drsenje po strani poslušaj scroll na document, za spremembe znotraj vsebnika pa neposredno na drsnem elementu. scroll sporoči spremembo položaja pri drsenju, ne glede na to, ali jo je sprožil uporabnik ali koda. wheel sporoči vnos, ki ne povzroči nujno drsenja. Spremembo velikosti vidnega območja spremljaj z resize na window; ta dogodek se ne širi v fazi mehurčkanja. Za opazovanje velikosti elementa uporabi ResizeObserver.

Podaj { passive: true } v objektu z možnostmi kot tretji argument addEventListener(); sama logična vrednost na tem mestu nastavi capture, ne passive. V pasivnem poslušalcu preventDefault() nima učinka in lahko izpiše opozorilo. { passive: false } omogoča preklic privzetega dejanja le, če je event.cancelable enak true. Dogodkov scroll dokumenta ali elementa in resize okna, ki jih sproži brskalnik, ni mogoče preklicati; možnost tega ne spremeni.

Pri vnosu, kot sta wheel ali touchmove, lahko brskalnik s pasivnim poslušalcem začne drsenje, ne da bi počakal, da poslušalec konča. Če možnost izpustiš, je lahko privzeta vrednost odvisna od dogodka, tarče in brskalnika. Nastavi passive: true, če vnos samo opazuješ. Če moraš dejanje preklicati, nastavi passive: false in preveri event.cancelable.

passive ne zmanjša niti pogostosti klicev niti zahtevnosti dela. Poskrbi, da je obdelava pogostih dogodkov kratka; če se mora zahtevno delo izvajati redkeje, omeji njegovo pogostost s časovnikom. requestAnimationFrame() pomaga uskladiti vizualne posodobitve s sličicami, vendar sam po sebi ne zagotavlja nižje pogostosti kot scroll.

Za odstranitev poslušalca pokliči removeEventListener() na isti tarči z isto vrsto dogodka, isto funkcijo in isto vrednostjo capture; passive se pri ujemanju ne upošteva. Ti API-ji so del spletne platforme, ne ECMAScript 2024. Preveri podporo v ciljnem izvajalnem okolju.

Primeri

{
  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

Zaženi kodo v konzoli brskalnika. Sintetični dogodki ne premaknejo strani in ne spremenijo velikosti okna. Samo zadnji primer nastavi `defaultPrevented` na `true`: dogodek je mogoče preklicati, poslušalec pa ni pasiven. Poskus preklica v pasivnem poslušalcu lahko izpiše ločeno opozorilo.

Povezane lekcije

  • JavaScript · Lekcija 11 · Napredna · Različica: 4

Viri