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

CKTIS / JavaScript

Voľba `passive` v `EventTarget.addEventListener()`

Pri `passive: true` poslucháč dostane udalosť, ale nemôže zrušiť jej predvolenú akciu. Vynechanie voľby nie je vždy to isté ako odovzdanie hodnoty `false`.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

target.addEventListener(type, listener)
target.addEventListener(type, listener, useCapture)
target.addEventListener(type, listener, { passive: true })
target.addEventListener(type, listener, { passive: false })

passive je voliteľná booleovská vlastnosť objektu odovzdaného ako tretí argument metódy target.addEventListener(type, listener, options). Samostatná booleovská hodnota ako tretí argument nastavuje iba capture, nie passive. Ide o rozhranie DOM webovej platformy, nie o funkciu jazyka ECMAScript 2024; over jeho podporu v cieľovom prostredí.

Pri passive: true sa poslucháč naďalej spúšťa, no jeho volanie event.preventDefault() nemá účinok a môže vyvolať upozornenie v konzole. Šírenie udalosti sa tým nemení. Pri passive: false môže poslucháč zrušiť predvolenú akciu pomocou preventDefault(), ale len ak má event.cancelable hodnotu true.

Ak vynecháš passive, štandard DOM určuje ako predvolenú hodnotu false, okrem udalostí wheel, mousewheel, touchstart a touchmove pri registrácii na Window, Document, document.documentElement alebo document.body: v týchto prípadoch určuje true. Samotná podpora voľby nezaručuje použitie týchto predvolených hodnôt: prípady, keď sa ako predvolená hodnota používalo true, sa líšili podľa prehliadača a jeho verzie, a to aj v Safari. Ak potrebuješ akciu zrušiť, výslovne nastav false. Ak chceš vstup len sledovať, nastav true, aby prehliadač mohol začať posúvať obsah bez čakania na poslucháča. Samotnú udalosť scroll nemožno zrušiť.

Opätovná registrácia na rovnakom cieli s rovnakým typom, tou istou funkciou a rovnakou hodnotou capture nezmení passive. Pomocou removeEventListener() odstráň poslucháča so zhodným typom, funkciou a hodnotou capture a potom ho znova pridaj. passive sa pri vyhľadávaní poslucháča na odstránenie nepoužíva a neriadi jeho životnosť.

Príklady

{
  const target = new EventTarget();
  const type = "passive-demo";
  const listener = (event) => event.preventDefault();

  for (const passive of [true, false]) {
    target.addEventListener(type, listener, { passive });
    const event = new Event(type, { cancelable: true });
    const result = target.dispatchEvent(event);
    console.log(`passive=${passive}, defaultPrevented=${event.defaultPrevented}, dispatchEvent=${result}`);
    target.removeEventListener(type, listener);
  }
}

Výsledok

passive=true, defaultPrevented=false, dispatchEvent=true
passive=false, defaultPrevented=true, dispatchEvent=false

Každý priechod vyvolá novú syntetickú udalosť, ktorú možno zrušiť. `defaultPrevented` ukazuje, či bola zrušená, a `dispatchEvent()` vráti `false` iba v priechode, v ktorom sa ju podarí zrušiť. Prehliadač môže zobraziť upozornenie; príklad nemeria výkon posúvania.

Súvisiace lekcie

  • JavaScript · Lekcia 33 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 36 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 45 · Pokročilá · Verzia: 4

Zdroje