Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

onpopstate — spracovanie zmien aktívnej položky histórie

Atribút onpopstate prvku body nastavuje obsluhu udalosti popstate objektu Window. Stránka tak môže reagovať na prechádzanie históriou relácie, napríklad pomocou tlačidiel Späť a Dopredu, a čítať stav cieľovej položky.

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

Syntax

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

onpopstate je atribút obsluhy udalosti dostupný na prvku body, nie globálny atribút pre ľubovoľné prvky. Sprístupňuje obsluhu popstate objektu Window. Priradenie window.onpopstate = handleState nastaví tú istú obsluhu; nevytvorí druhý, nezávislý listener.

Udalosť popstate súvisí s prechádzaním históriou relácie, napríklad pomocou tlačidiel Späť a Dopredu alebo volaním history.back(). Samotné volanie history.pushState() alebo history.replaceState() túto udalosť nevyvolá. V obsluhe obsahuje event.state obnovený stav cieľovej položky. Môže mať hodnotu null, preto s tým počítaj pred prístupom k jeho vlastnostiam.

Neskoršie priradenie k window.onpopstate nahradí predchádzajúcu obsluhu a priradenie null ju odstráni. Pre nezávislé obsluhy použi window.addEventListener('popstate', handleState). Nepovažuj popstate za možnosť zrušiť navigáciu.

Príklad zámerne vyvolá syntetickú udalosť PopStateEvent s pevným stavom. Overuje prepojenie atribútu s Window, ale nemení históriu ani netestuje skutočné prechádzanie históriou. CSP aplikácie môže blokovať atribúty inline obsluhy; v takom prípade zaregistruj obsluhu v povolenom skripte.

Príklady

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

Výsledok

step=1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje