Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

onpopstate — obrada promjena aktivnog unosa u povijesti

Atribut onpopstate elementa body postavlja rukovatelj događajem popstate objekta Window. Stranica tako može reagirati na kretanje kroz povijest sesije, primjerice pomoću gumba Natrag i Naprijed, te pročitati stanje odredišnog unosa.

Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<body onpopstate="handleState(event)">
window.onpopstate = handleState;

onpopstate je atribut rukovatelja događajima dostupan na elementu body, a ne globalni atribut za proizvoljne elemente. Omogućuje rukovatelja popstate objekta Window. Dodjela window.onpopstate = handleState postavlja istog rukovatelja; ne stvara drugog, neovisnog slušatelja.

Događaj popstate povezan je s kretanjem kroz povijest sesije, primjerice pomoću gumba Natrag i Naprijed ili pozivom history.back(). Sam poziv history.pushState() ili history.replaceState() ne pokreće taj događaj. U rukovatelju event.state sadrži vraćeno stanje odredišnog unosa. Može biti null, pa to uzmi u obzir prije pristupa njegovim svojstvima.

Kasnija dodjela vrijednosti za window.onpopstate zamjenjuje prethodnog rukovatelja, a dodjela vrijednosti null uklanja ga. Za neovisne rukovatelje upotrijebi window.addEventListener('popstate', handleState). Nemoj smatrati popstate načinom za otkazivanje navigacije.

Primjer namjerno šalje sintetički događaj PopStateEvent s fiksnim stanjem. Provjerava povezanost atributa s objektom Window, ali ne mijenja povijest niti testira stvarno kretanje kroz nju. CSP aplikacije može blokirati atribute rukovatelja u retku; u tom slučaju registriraj rukovatelja u dopuštenoj skripti.

Primjeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onpopstate demo</title>
</head>
<body onpopstate="document.getElementById('result').textContent = 'step=' + event.state.step">
  <button id="test" type="button">Test</button>
  <output id="result">Ready</output>
  <script>
    document.getElementById('test').addEventListener('click', () => {
      window.dispatchEvent(new PopStateEvent('popstate', {
        state: { step: 1 }
      }));
    });
  </script>
</body>
</html>

Rezultat

step=1

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori