Obiekt Location
Obiekt Location
Obiekt Location zawiera informacje dotyczące aktualnego URL.
Obiekt Location jest częścią obiektu Window, który można uzyskać za pomocą atrybutu window.location.
Przykład
Atrybuty obiektu Location
Atrybuty | Opis |
---|---|
hash | Ustawia lub zwraca część URL (ankr) zaczynającą się od znaku hash (#). |
host | Ustawia lub zwraca nazwę hosta i port aktualnego URL. |
hostname | Ustawia lub zwraca nazwę hosta aktualnego URL. |
href | Ustawia lub zwraca pełny URL. |
pathname | Ustawia lub zwraca część ścieżki URL. |
port | Ustawia lub zwraca port aktualnego URL. |
protocol | Ustawia lub zwraca protokół aktualnego URL. |
search | Ustawia lub zwraca część URL (część zapytania) zaczynającą się od znaku zapytania (?). |
Metody obiektu Location
Atrybuty | Opis |
---|---|
assign() | Załaduj nowy dokument. |
reload() | Ponownie załaduj aktualny dokument. |
replace() | Zastąp aktualny dokument nowym dokumentem. |
Opis obiektu Location
Obiekt Location jest przechowywany w atrybucie Location obiektu Window, oznacza to adres Web aktualnie wyświetlanego dokumentu w oknie. Jego Atrybut hrefZawiera pełny URL dokumentu, inne atrybuty opisują poszczególne części URL. Te atrybuty są bardzo podobne do atrybutu URL obiektu Anchor (lub obiektu Area). Kiedy obiekt Location jest przekształcony w ciąg znaków, zwracana jest wartość atrybutu href. Oznacza to, że możesz używać wyrażenia location zamiast location.href.
Jednak obiekt Anchor reprezentuje hiperłącze w dokumencie, podczas gdy obiekt Location reprezentuje URL (lub pozycję) bieżącego dokumentu wyświetlanego przez przeglądarkę. Jednak obiekt Location może zrobić więcej niż to, kontrolując pozycję dokumentu wyświetlanego przez przeglądarkę. Jeśli przypisze się do obiektu Location lub jego właściwości href ciąg znaków zawierający URL, przeglądarka załaduje i wyświetli dokument wskazywany przez nowy URL.
Oprócz zastąpienia bieżącego URL pełnym URL za pomocą location lub location.href, można również zmodyfikować część URL, wystarczy przypisać wartości innym właściwości obiektu Location. W ten sposób zostanie utworzony nowy URL, w którym część jest inna niż w oryginalnym URL. Przeglądarka załaduje i wyświetli go. Na przykład, jeśli ustawiono właściwość hashwtedy przeglądarka przejdzie do określonej pozycji w bieżącym dokumencie. Podobnie, jeśli ustawiono właściwość searchwtedy przeglądarka przeładuje URL z nową ciągłą wartością zapytania.
Oprócz właściwości URL, obiekt Location Metoda reload()Można ponownie załadować bieżący dokumentreplace() Można załadować nowy dokument bez konieczności tworzenia nowej historii, co oznacza, że nowy dokument zastąpi bieżący dokument w liście historii przeglądarki.