Objekti brskalnika: History
Objekt history razreda window predstavlja zgodovino seje v trenutnem zavihku ali okviru. Z njim lahko uporabnika premaknemo na prejšnjo ali naslednjo stran v zgodovini seje oziroma na poljubni odmik v tej zgodovini. Zaradi zasebnosti JavaScript ne more prebrati seznamov naslovov, ki jih je uporabnik obiskal, lahko pa po zgodovini seje krmari in v sodobnih primerih upravlja tudi stanje z metodama pushState() in replaceState().
Osnovna pravila
- Objekt
historyje lastnost objektawindow. - Metoda
back()se obnaša podobno kot gumb Nazaj v brskalniku. - Metoda
forward()se obnaša podobno kot gumb Naprej v brskalniku. - Metoda
go(odmik)premakne trenutno stran glede na odmik v zgodovini seje. - Lastnost
history.lengthvrne število vnosov v zgodovini seje, vključno s trenutno stranjo.
Primerjave
Osnovne metode objekta history
| Metoda | Opis |
|---|---|
history.back() | premakne stran en korak nazaj v zgodovini seje |
history.forward() | premakne stran en korak naprej v zgodovini seje |
history.go(odmik) | premakne stran za podani odmik nazaj ali naprej |
Metoda back()
Metoda back() premakne brskalnik na prejšnji vnos v zgodovini seje. Enak učinek ima tudi history.go(-1).
<script>
function nazaj() {
history.back();
}
</script>
<input type="button" value="Nazaj" onclick="nazaj()">Metoda forward()
Metoda forward() premakne brskalnik na naslednji vnos v zgodovini seje. Enak učinek ima tudi history.go(1).
<script>
function naprej() {
history.forward();
}
</script>
<input type="button" value="Naprej" onclick="naprej()">Metoda go()
Metoda go() premakne brskalnik za izbrani odmik v zgodovini seje. Negativna vrednost pomeni pomik nazaj, pozitivna naprej. Klic brez argumenta ali z vrednostjo 0 ponovno naloži trenutno stran.
<script>
function triNazaj() {
history.go(-3);
}
</script>
<input type="button" value="Vrni se 3 strani nazaj" onclick="triNazaj()">Lastnosti objekta history
Najpomembnejši lastnosti pri osnovni razlagi sta length in state.
| Lastnost | Opis |
|---|---|
history.length | vrne število vnosov v zgodovini seje, vključno s trenutno stranjo |
history.state | vrne trenutno stanje zgodovine, če je bilo nastavljeno z pushState() ali replaceState() |
Lastnost length
Lastnost history.length vrne število vnosov v zgodovini seje trenutnega zavihka.
<p id="primer"></p>
<script>
document.getElementById("primer").textContent =
"Število vnosov v zgodovini seje: " + history.length;
</script>Zgodovina stanja
Sodobna History API poleg premikanja po zgodovini omogoča tudi dodajanje ali zamenjavo stanja trenutne strani z metodama pushState() in replaceState(). To je uporabno predvsem v enostranskih spletnih aplikacijah, kjer želimo spreminjati naslov ali stanje brez polnega ponovnega nalaganja strani.
history.pushState({ korak: 1 }, "", "?korak=1");
history.replaceState({ korak: 2 }, "", "?korak=2");Priporočila
- Za osnovno premikanje po zgodovini seje uporabljaj metode
back(),forward()ingo(). - Upoštevaj omejitve zasebnosti, zato z JavaScriptom ne poskušaj brati seznama obiskanih naslovov.
- Za preproste primere preverjaj lastnost
history.length, za zahtevnejše primere pa uporabljajhistory.state,pushState()inreplaceState(). - Za izpis navadnega besedila v dokument uporabljaj
textContent. - Dogodek
popstateuporabljaj pri obravnavi premikanja po zgodovini seje.
Pogoste napake
- Metodi
back()inforward()se zapisujeta z napačnim imenom objekta, na primerhitorynamestohistory. - Lastnost
history.lengthse razume kot število naslovov, ki jih lahko JavaScript prebere, čeprav gre le za število vnosov v zgodovini seje. - Predpostavi se, da bo
history.go(-3)vedno uspešno izveden, čeprav se nič ne zgodi, kadar takega odmika ni v zgodovini. - Metodi
pushState()inreplaceState()se razlagata kot neposredni navigaciji na novo stran, čeprav praviloma le spremenita stanje in po potrebi naslov znotraj istega izvora. - Dogodek
popstatese pričakuje takoj po klicupushState()alireplaceState(), čeprav se ob teh klicih sam po sebi ne sproži.
Vprašanja in komentarji
Vprašanje je lahko zasebno ali vidno vsem, ki imajo dostop do strani.
Za to stran še ni vprašanj.