SELFHTML: JavaScript / Objektreferenz / location
Description: (SELFHTML 7.0) Das JavaScript-Objekt location
Keywords: SELFHTML, JavaScript, Objekt, location-Objekt

SELFHTML/Quickbar JavaScript Objektreferenz

| ## location
| 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.

## 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.

## 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.

## 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.

## 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.

## 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.

## 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.

## 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.

## 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.

## 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.

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