Location-objekti

Location-objekti

Location-objekti sisältää tietoja nykyisestä URL:stä.

Location-objekti on osa Window-objektia, johon voidaan päästä käyttämällä window.location-ominaisuutta.

Esimerkki

Vie käyttäjän uuteen osoitteeseen

Location-objektin ominaisuudet

Ominaisuudet Kuvaus
hash Aseta tai palauta URL:n (kaksipisteestä # alkaen) osa (ankkuri).
host Aseta tai palauta isäntänimi ja nykyisen URL:n portti.
hostname Aseta tai palauta nykyisen URL:n isäntänimi.
href Aseta tai palauta kokonainen URL.
pathname Aseta tai palauta URL:n polkuosa.
port Aseta tai palauta nykyisen URL:n portti.
protocol Aseta tai palauta nykyisen URL:n protokolla.
search Aseta tai palauta URL:n (kysymysmerkistä ? alkaen) osa (hakukohde).

Location-objektin metodit

Ominaisuudet Kuvaus
assign() Lataa uusi dokumentti.
reload() Lataa uudelleen nykyinen dokumentti.
korvaa() Korvaa nykyisen dokumentin uudella dokumentilla.

Location-objektin kuvaus

Location-objekti tallennetaan Window-objektin Location-ominaisuuteen ja se edustaa nykyisessä ikkunassa näytettävän dokumentin Web-osoitetta. Sen href-ominaisuusSisältää dokumentin kokonaisen URL-osoitteen, muiden ominaisuuksien avulla kuvataan URL:n eri osia. Nämä ominaisuudet ovat hyvin samanlaisia kuin Anchor- tai Area-objektien URL-ominaisuudet. Kun Location-objekti muunnetaan merkkijonoksi, palautetaan href-ominaisuuden arvo. Tämä tarkoittaa, että voit käyttää ilmaisua location korvaamaan location.href.

Kuitenkin AnchorObjekti edustaa dokumentin sisäistä hyperlinkkiä, LocationObjekti edustaa selaimen nykyisesti näyttämää dokumentin URL:ää (tai sijaintia). Mutta LocationObjekti voi tehdä paljon enemmän kuin tämän, se voi myös hallita selaimen näyttämää dokumentin sijaintia. Jos URL-merkkijono annetaan LocationObjektille tai sen href-ominaisuudelle, selain lataa ja näyttää uuden URL:n mukaisen dokumentin.

Paitsi asettamalla location tai location.href täydellä URL:llä nykyisen URL:n korvaamiseksi, voi myös muuttaa osaa URL:stä, vain asettamalla LocationObjektiin tai sen href-ominaisuuteen muiden ominaisuuksien arvot. Tämä luo uuden URL:n, jossa osa on erilainen kuin alkuperäisessä URL:ssä, ja selain lataa ja näyttää sen. Esimerkiksi, jos on asetettu LocationObjektiin hashOminaisuussitten selain siirtyy nykyisen dokumentin määrittämään sijaintiin. Samoin, jos on asetettu searchOminaisuussitten selain lataa uudelleen URL:hen, johon on lisätty uusi hakusana.

Paitsi URL-ominaisuuden lisäksi, LocationObjektiin kuuluu reload()MetodiVoit uudelleenladata nykyisen dokumentin,korvaa() Voit ladata uuden dokumentin ilman, että sinun täytyy luoda uusi historia sille, eli uusi dokumentti korvaa nykyisen dokumentin selaimen historian luettelossa.