Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onpageswap — obravnava odhajajočega dokumenta med navigacijo

Atribut onpageswap na body nastavi obravnavo dogodka pageswap na objektu Window. Dogodek zadeva odhajajoči dokument med navigacijo; ne sporoča, da se je prikazala nova stran.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<body onpageswap="JavaScript statements">

onpageswap je vsebinski atribut, ki vsebuje kodo JavaScript za obravnavo dogodka pageswap. Na elementu body nastavi obravnavo na objektu Window, ne pa neodvisne obravnave na tem elementu. Ni logični atribut: njegova vrednost je koda, parameter event pa posreduje dogodek.

Brskalnik lahko sproži pageswap na oknu odhajajočega dokumenta, ko ta zaradi navigacije ni več aktiven. Dokumenta ni treba odstraniti iz pomnilnika: dogodek se lahko sproži tudi, ko ga brskalnik ohrani v predpomnilniku za navigacijo nazaj in naprej (bfcache). Dejanski dogodek uporablja vmesnik PageSwapEvent; njegova lastnost viewTransition lahko zagotovi prehod pogleda ali ima vrednost null. Tega dogodka ne zamenjujte z dogodkom pagereveal, ki zadeva začetek izrisovanja dokumenta. pageswap ni namenjen preklicu navigacije.

Atribut na body in lastnost window.onpageswap nastavita isto obravnavo: dodelitev nove funkcije zamenja prejšnjo. Alternativa window.addEventListener('pageswap', handler) doda neodvisne obravnave, ne da bi zamenjala to lastnost. Politika Content Security Policy lahko blokira kodo v atributih; v tem primeru uporabite dovoljeno zunanjo skripto.

Skripta v primeru v konzolo izpiše le rezultata dveh preverjanj: ali ima element body atribut onpageswap in ali je na objektu window na voljo lastnost onpageswap. Skripta ne sproži nobenega dogodka niti ne začne navigacije, zato izpis ne potrjuje, da se funkcija za obravnavo dogodka, določena v atributu, izvede.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri