SELFHTML/Quickbar  JavaScript  Objektreferenz

location
Diese Seite ist ein Dokument mit Informationstext

 location: Allgemeines zur Verwendung

Eigenschaften:

 hash (Ankername innerhalb einer URL)
 host (Domain-Name innerhalb einer URL)
 hostname (Domain-Name innerhalb einer URL)
 href (URL / Verweis zu URL)
 pathname (Pfadname innerhalb einer URL)
 port (Portangabe innerhalb einer URL)
 protocol (Protokollangabe innerhalb einer URL)
 search (Parameter innerhalb einer URL)

Methoden:

 reload() (neu laden)
 replace() (History-Eintrag überschreiben)
 

location: Allgemeines zur Verwendung

Über das Objekt location, das in der JavaScript-Objekthierarchie unterhalb des  window-Objekts liegt, haben Sie Zugriff auf die vollständige URL-Adresse der aktuell angezeigten WWW-Seite. Sie können die URL-Adresse oder Teile davon zur Weiterverarbeitung abfragen und ändern. Beim Ändern führt der WWW-Browser einen Sprung zu einer neuen URL-Adresse aus, genau so wie bei einem Verweis.

Beispiele:

window.location.href = "datei2.htm";
MeineDomain = location.host;

parent.frames[1].location.href = "datei2.htm";
Zweitfenster.host = "www.teamone.de";

Erläuterung:

Methoden des location-Objekts können Sie mit location aufrufen. Sie können auch window. davor notieren. Da es sich dabei aber um die Adresse des aktuellen Fensters handelt, ist die Angabe des Fensternamens nicht zwingend erforderlich. Anders beim Zugriff auf andere Fenster oder Frame-Fenster. In diesen Fällen müssen Sie das Fenster korrekt adressieren. Lesen Sie für zusätzliche Fenster den Abschnitt zur  Verwendung des window-Objekts und für Frame-Fenster den Abschnitt über die  Verwendung des frames-Objekts.

 

JavaScript 1.0Netscape2.0MS IE3.0Lesen/Ändern hash

Speichert den  Anker (Verweisziel) innerhalb der URL-Adresse.

Beispiel:

<html><head><title>Test</title>
<script language="JavaScript">
function Zeigen()
{ alert(window.location.hash); }
</script>
</head><body>
<a href="#a2">Gehe zu a2. Bitte zuerst klicken</a>
<p>
<a name="a2" href="javascript:Zeigen()">Hier a2 - bitte dann klicken</a>
</body></html>

Erläuterung:

Das Beispiel definiert zwei Verweise. Beim Anklicken des ersten Verweises wird zu dem Ziel a2 innerhalb der Datei gesprungen. Dies ist selbst wieder ein Verweis. Beim Anklicken dieses zweiten Verweises wird die Funktion Zeige() aufgerufen, die den Ankernamen ausgibt. Beachten Sie, daß das Gatterzeichen # mit zu dem Wert gehört, den hash liefert.
Wenn Sie diese Angabe ändern, bewirken Sie einen Verweis innerhalb der Datei zu dem angegebenen Anker. Auch dabei müssen Sie das Gatterzeichen vor dem Ankernamen hinzufügen.

 

JavaScript 1.0Netscape2.0MS IE3.0Lesen/Ändern host

Speichert den Namen des Server-Rechners innerhalb der aktuellen oder fensterspezifischen URL-Adresse.

Beispiel:

<html><head><title>Test</title>
<script language="JavaScript">
 alert("Sie befinden sich auf dem Host " + window.location.host);
</script>
</head><body>
</body></html>

Erläuterung:

Das Beispiel gibt beim Einlesen der Datei aus, auf welchem Host-Rechner sich der Anwender befindet. Wenn es eine Namensadresse wie etwa www.teamone.de ist, wird diese ausgegeben. Wenn es eine numerische IP-Adresse wie etwa 195.201.34.18 ist, wird diese ausgegeben.
Sie können die Eigenschaft ändern. Sicherer ist es in diesem Fall jedoch, mit der Eigenschaft  href zu arbeiten.

 

JavaScript 1.0Netscape2.0MS IE3.0Lesen/Ändern hostname

Speichert den Namen des Server-Rechners innerhalb der aktuellen oder fensterspezifischen URL-Adresse. Im Unterschied zu  host auch Sub-Domains und Portnummern.

Beispiel:

<html><head><title>Test</title>
<script language="JavaScript">
 alert("Sie befinden sich auf dem Host " + window.location.hostname);
</script>
</head><body>
</body></html>

Erläuterung:

Das Beispiel gibt beim Einlesen der Datei aus, auf welchem Host-Rechner sich der Anwender befindet. Wenn es eine Namensadresse wie etwa www.teamone.de ist, wird diese ausgegeben. Wenn es eine numerische IP-Adresse wie etwa 195.201.34.18 ist, wird diese ausgegeben. Wenn beispielsweise eine Portnummer dazugehört, wie www.xy.de:5080, wird auch diese gespeichert.
Sie können die Eigenschaft ändern. Sicherer ist es in diesem Fall jedoch, mit der Eigenschaft  href zu arbeiten.

 

JavaScript 1.0Netscape2.0MS IE3.0Lesen/Ändern href

Speichert die vollständige URL-Adresse des aktuellen oder eines anderen Fensters.

Beispiel:

<html><head><title>Test</title>
<script language="JavaScript">
function Wunsch()
{
 Ziel = window.prompt("Ihre Wunsch-URL:","");
 window.location.href = Ziel;
}
</script>
</head><body>
<a href="javascript:Wunsch()">Wunschverweis</a>
</body></html>

Erläuterung:

Das Beispiel enthält einen Verweis. Bim Anklicken des Verweises wird die Funktion Wunsch() aufgerufen. Diese Funktion blendet ein Dialogfenster ein, in dem der Anwender eine URL-Adresse seiner Wahl eingeben kann. Der eingegebene Wert wird in der Variablen Ziel gespeichert. Anschließend wird durch Zuweisung von Ziel an window.location.href ein Verweis zu dieser URL-Adresse ausgeführt.
Es muß sich dabei nicht um eine vollständige URL handeln. Ein Dateiname genügt, wenn der Sprung einfach nur zu einer anderen Projektdatei im gleichen Verzeichnis führen soll.

 

JavaScript 1.0Netscape2.0MS IE3.0Lesen/Ändern pathname

Speichert den Pfadnamen innerhalb der aktuellen oder fensterspezifischen URL-Adresse. Bei lokaler Verwendung (ohne HTTP-Protokoll) wird die vollständige lokale Adresse gespeichert.

Beispiel:

<html><head><title>Test</title>
<script language="JavaScript">
 alert("Aktueller Pfad: " + window.location.pathname);
</script>
</head><body>
</body></html>

Erläuterung:

Das Beispiel gibt beim Einlesen der Datei in einem Meldungsfenster den Pfadnamen der URL-Adresse der Datei aus.
Sie können die Eigenschaft ändern. Sicherer ist es in diesem Fall jedoch, mit der Eigenschaft  href zu arbeiten.

 

JavaScript 1.0Netscape2.0Lesen/Ändern port

Speichert den Port innerhalb der aktuellen oder fensterspezifischen URL-Adresse. Eine Adresse mit Ports ist etwa http://www.xy.de:5080/ - die Eigenschaft port enthält nur dann einen Wert, wenn in der aktuellen URL-Adresse tatsächlich eine Portangabe enthalten ist.

Beispiel:

<html><head><title>Test</title>
<script language="JavaScript">
if(window.location.port != "")
 alert(window.location.port);
</script>
</head><body>
</body></html>

Erläuterung:

Das Beispiel ermittelt beim Einlesen der Datei, ob eine Portangabe vorhanden ist. Wenn ja, wird sie in einem Meldungsfenster ausgegeben.
Sie können die Eigenschaft ändern. Dies kann jedoch zu Fehlermeldungen führen, wenn der Server den Port nicht kennt. Der "Normal-Port" für HTTP-Adressen ist 80.

 

JavaScript 1.0Netscape2.0Lesen/Ändern protocol

Speichert das verwendete Protokoll innerhalb der aktuellen oder fensterspezifischen URL-Adresse. Bei HTTP-Adressen wird http: gespeichert. Bei lokaler Verwendung (ohne HTTP-Protokoll) wird file: gespeichert.

Beispiel:

<html><head><title>Test</title>
<script language="JavaScript">
 alert(window.location.protocol);
</script>
</head><body>
</body></html>

Erläuterung:

Das Beispiel gibt beim Einlesen der Datei das Protokoll aus, das zur aktuellen URL-Adresse gehört.
Sie können die Eigenschaft ändern. Dies kann jedoch zu Fehlermeldungen führen, wenn das angegebene Protokoll mit der gleichen sonstigen Adresse nicht unterstützt wird.

 

JavaScript 1.0Netscape2.0Lesen/Ändern search

Speichert eine Zeichenkette, die, durch ein Fragezeichen getrennt, an die aktuelle URL-Adresse angehängt ist, zum Beispiel:
http://www.xy.de/index.htm?Browser=Netscape.
In diesem Fall enthält die Eigenschaft den Wert ?Browser=Netscape.

Beispiel:

<html><head><title>Test</title>
if(window.location.search != "")
 alert(window.location.search);
</script>
</head><body>
</body></html>

Erläuterung:

Das Beispiel ermittelt beim Einlesen der Datei, ob eine zusätzliche Angabe zur URL-Adresse mit einem Fragzeichen vorhanden ist. Wenn ja, wird sie in einem Meldungsfenster ausgegeben.
Sie können (funktioniert nur mit Netscape) mit  href eine andere Datei aufrufen und an die URL-Adresse, durch ein Fragezeichen getrennt, Informationen anhängen, zum Beispiel solche, die Sie mit JavaScript ermittelt haben - Formulareingaben oder dergleichen. Die aufgerufene Datei kann solche Informationen auslesen und weiterverarbeiten. Auf diese Weise ist "Kommunikation" zwischen Dateien möglich.

 

JavaScript 1.1Netscape3.0MS IE4.0 reload()

Lädt eine WWW-Seite neu. Hat den gleichen Effekt wie der Reload-Button im Browser.

Beispiel:

<a href="javascript:location.reload()">Reload</a>

Erläuterung:

Das Beispiel definiert einen Verweis, bei dessen Anklicken die aktuelle Seite noch einmal neu geladen wird.

 

JavaScript 1.1Netscape3.0MS IE4.0 replace()

Lädt eine andere URL-Adresse über den aktuellen Eintrag in der Liste der besuchten Seiten (History). Hat dadurch einen ähnlichen Effekt wie die Eigenschaft  href. Der Unterschied ist, daß die aktuelle URL-Adresse anschließend in der Liste der besuchten Seiten nicht mehr vorkommt.

Beispiel:

<a href="javascript:location.replace('datei2.htm')">Datei 2</a>

Erläuterung:

Das Beispiel definiert einen Verweis, bei dessen Anklicken datei2.htm geladen wird. Die aktuelle URL-Adresse verschwindet dabei aus der Liste der besuchten Seiten.

weiter: Array
zurück: history
 

SELFHTML/Quickbar  JavaScript  Objekt-Referenz

© 1998  Stefan Münz, muenz@csi.com

1