CKTIS / JavaScript
Volba `passive` v `EventTarget.addEventListener()`
S volbou `passive: true` posluchač událost přijme, ale nemůže zrušit její výchozí akci. Vynechat tuto volbu neznamená vždy totéž jako předat `false`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
target.addEventListener(type, listener)
target.addEventListener(type, listener, useCapture)
target.addEventListener(type, listener, { passive: true })
target.addEventListener(type, listener, { passive: false })passive je nepovinná booleovská vlastnost objektu předávaného jako třetí argument metody target.addEventListener(type, listener, options). Samostatná booleovská hodnota na třetí pozici nastavuje jen capture, nikoli passive. Jde o rozhraní DOM webové platformy, ne o vlastnost jazyka ECMAScript 2024; ověř jeho podporu v cílovém prostředí.
Při passive: true se posluchač nadále spouští, ale jeho volání event.preventDefault() nemá žádný účinek a může vyvolat varování v konzoli. Šíření události se tím nemění. Při passive: false může posluchač zrušit výchozí akci pomocí preventDefault(), ale jen pokud má event.cancelable hodnotu true.
Při vynechání passive stanoví standard DOM jako výchozí hodnotu false, s výjimkou událostí wheel, mousewheel, touchstart a touchmove při registraci na Window, Document, document.documentElement nebo document.body: v těchto případech stanoví true. Samotná podpora volby nezaručuje použití těchto výchozích hodnot: případy, kdy se jako výchozí hodnota používalo true, se lišily podle prohlížeče a jeho verze, a to i v Safari. Pokud potřebuješ akci zrušit, nastav výslovně false. Pokud chceš vstup jen sledovat, použij true, aby prohlížeč mohl začít posouvat obsah bez čekání na posluchače. Samotnou událost scroll zrušit nelze.
Opětovná registrace na stejném cíli se stejným typem události, stejnou funkcí a stejnou hodnotou capture nezmění passive. Odeber posluchače pomocí removeEventListener() s odpovídajícím typem, funkcí a hodnotou capture a pak ho znovu přidej. passive se při hledání posluchače k odebrání nepoužívá ani neřídí dobu jeho registrace.
Pří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ýsledek
passive=true, defaultPrevented=false, dispatchEvent=true passive=false, defaultPrevented=true, dispatchEvent=false
Každý průchod vyvolá novou syntetickou událost, kterou lze zrušit. `defaultPrevented` ukazuje, zda byla zrušena, a `dispatchEvent()` vrátí `false` jen v průchodu, ve kterém se ji podaří zrušit. Prohlížeč může zobrazit varování; příklad neměří výkon posouvání.
Související lekce
- JavaScript · Lekce 33 · Pokročilá · Verze: 4
- JavaScript · Lekce 36 · Pokročilá · Verze: 4
- JavaScript · Lekce 45 · Pokročilá · Verze: 4