CKTIS / HTML
onpageswap — obrada odlaznog dokumenta tijekom navigacije
Atribut onpageswap na elementu body postavlja rukovatelj na objektu Window za događaj pageswap. Taj se događaj odnosi na odlazni dokument tijekom navigacije; ne obavještava o pojavi nove stranice.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onpageswap="JavaScript statements">onpageswap je sadržajni atribut koji sadrži JavaScript kod za rukovatelja događajem pageswap. Na elementu body postavlja rukovatelja na objektu Window, a ne zasebnog rukovatelja na tom elementu. Nije Booleov atribut: njegova je vrijednost kod, a parametar event sadrži događaj.
Preglednik može poslati događaj pageswap prozoru odlaznog dokumenta kada dokument zbog navigacije prestaje biti aktivan. Dokument se ne mora ukloniti iz memorije: događaj se može pokrenuti i kada preglednik zadrži dokument u predmemoriji za navigaciju natrag i naprijed (bfcache). Stvarni događaj upotrebljava sučelje PageSwapEvent; njegovo svojstvo viewTransition može pružiti prijelaz prikaza ili imati vrijednost null. Nemojte miješati taj događaj s događajem pagereveal, koji se odnosi na početak prikaza dokumenta. pageswap ne služi za otkazivanje navigacije.
Atribut na elementu body i svojstvo window.onpageswap postavljaju istog rukovatelja: dodjela nove funkcije zamjenjuje prethodnu. Alternativa window.addEventListener('pageswap', handler) dodaje neovisne rukovatelje bez zamjene tog svojstva. Pravila Content Security Policy mogu blokirati kod u atributima; tada upotrijebite dopuštenu vanjsku skriptu.
Skripta u primjeru ispisuje u konzolu samo rezultate dviju provjera: ima li element body atribut onpageswap i je li svojstvo onpageswap dostupno na objektu window. Skripta ne pokreće događaj ni navigaciju, pa ispis ne potvrđuje da se rukovatelj definiran u atributu izvršava.
Primjeri
<!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>
Rezultat
onpageswap attribute present: true onpageswap event property available: true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.