CKTIS / JavaScript
Събитията `scroll` и `resize` и опцията `passive`
Избери правилната цел за събитията при превъртане и промяна на размерите и разбери кога пасивният слушател не позволява отмяна на действието по подразбиране.
Версия: Current web platform; runtime support varies
Синтаксис
// 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();Слушай за scroll върху document при превъртане на страницата или директно върху превъртащия се елемент при промени в контейнер. scroll съобщава за промяна на позицията, независимо дали е предизвикана от потребителя, или от код. wheel съобщава за вход, който не води непременно до превъртане. Слушай за resize върху window при промяна на размера на видимата област; това събитие не се разпространява във възходящата фаза. За проследяване на размера на елемент използвай ResizeObserver.
Подай { passive: true } в обекта с опции като трети аргумент на addEventListener(); самостоятелна булева стойност на това място задава capture, а не passive. В пасивен слушател preventDefault() няма ефект и може да предизвика предупреждение. { passive: false } позволява отмяна на действието по подразбиране само ако event.cancelable е true. Генерираните от браузъра събития scroll на документ или елемент и resize на прозореца не могат да се отменят; опцията не променя това.
При вход като wheel или touchmove пасивният слушател позволява на браузъра да започне превъртане, без да чака слушателят да приключи. Ако пропуснеш опцията, стойността по подразбиране може да зависи от събитието, целта и браузъра. Задай passive: true, ако само наблюдаваш входа. Ако трябва да отмениш действието, задай passive: false и провери event.cancelable.
passive не намалява нито честотата на извикванията, нито натоварването от обработката. Поддържай обработчиците на чести събития кратки; ако тежка операция трябва да се изпълнява по-рядко, ограничи честотата ѝ с таймер. requestAnimationFrame() помага за синхронизиране на визуалните обновявания с кадрите, но само по себе си не гарантира по-ниска честота от scroll.
За да премахнеш слушателя, извикай removeEventListener() върху същата цел със същия тип събитие, същата функция и същата стойност на capture; passive не се взема предвид при съпоставянето. Тези API са част от уеб платформата, а не от ECMAScript 2024. Провери поддръжката в целевата среда за изпълнение.
Примери
{
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}`);
}
}Резултат
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
Изпълни кода в конзолата на браузъра. Синтетичните събития не превъртат страницата и не променят размера на прозореца. Само последният случай задава `defaultPrevented` на `true`: събитието може да се отмени и слушателят не е пасивен. Опитът за отмяна в пасивния слушател може да предизвика отделно предупреждение.
Свързани уроци
- JavaScript · Урок 11 · Напреднало · Версия: 4
Източници
- Document: scroll event
- Element: scroll event
- Window: resize event
- ResizeObserver
- EventTarget: addEventListener() method
- EventTarget: removeEventListener() method
- Event: preventDefault() method
- Element: wheel event
- Event: Event() constructor
- EventTarget: dispatchEvent() method
- HTML Standard: Processing model
- ECMAScript 2024 Language Specification: Hosts and Implementations