CKTIS / HTML
onpageswap — обработване на изходящ документ по време на навигация
Атрибутът onpageswap върху body задава обработчика на Window за събитието pageswap. Събитието се отнася до изходящия документ по време на навигация; то не уведомява, че се е появила нова страница.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<body onpageswap="JavaScript statements">onpageswap е атрибут на съдържанието, който съдържа JavaScript код за обработчик на събитието pageswap. Върху елемента body той задава обработчика на Window, а не независим обработчик на този елемент. Това не е булев атрибут: стойността му е код, а параметърът event предоставя събитието.
Браузърът може да изпрати събитието pageswap до прозореца на изходящия документ, когато документът престава да е активен поради навигация. Не е необходимо документът да бъде разтоварен: събитието може да възникне и когато браузърът запази документа в кеша за навигация назад и напред (bfcache). Реалното събитие използва интерфейса PageSwapEvent; свойството му viewTransition може да предостави преход на изгледа или да има стойност null. Не бъркайте това събитие с pagereveal, което се отнася до началото на визуализирането на документ. pageswap не служи за отмяна на навигация.
Атрибутът върху body и свойството window.onpageswap задават един и същ обработчик: присвояването на нова функция заменя предишната. Алтернативата window.addEventListener('pageswap', handler) добавя независими обработчици, без да заменя това свойство. Политиката Content Security Policy може да блокира код в атрибутите; в такъв случай използвайте разрешен външен скрипт.
Скриптът в примера извежда в конзолата само резултатите от две проверки: дали елементът body има атрибута onpageswap и дали свойството onpageswap е достъпно на обекта window. Скриптът не задейства събитие и не започва навигация, затова резултатът не потвърждава, че обработчикът, зададен в атрибута, се изпълнява.
Примери
<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Body onpageswap handler</title></head>
<body onpageswap="document.body.dataset.received = event.type">
<script>
console.log('onpageswap attribute present: ' + document.body.hasAttribute('onpageswap'));
console.log('onpageswap event property available: ' + ('onpageswap' in window));
</script>
</body>
</html>
Резултат
onpageswap attribute present: true onpageswap event property available: true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.