База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници