Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori