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

SELFHTML/Quickbar JavaScript Objektreferenz

| ## history
| history: Allgemeines zur Verwendung Eigenschaften: length (Anzahl besuchter Seiten) Methoden: back() (zurückspringen) forward() (vorwärtsspringen) go() (zu URL in History springen)

## history: Allgemeines zur Verwendung

Über das Objekt history, das in der JavaScript-Objekthierarchie unterhalb des window-Objekts liegt, haben Sie Zugriff auf die besuchten WWW-Seiten des Anwenders. Maßgeblich ist dabei die Liste, wie sie in der History-Liste des WWW-Browsers gespeichert ist, bei Netscape etwa erreichbar über den Menübefehl Window/History. Mit diesem Objekt können Sie z.B. Verweise vom Typ "springe zur zuletzt besuchten Seite" konstruieren.

### Beispiele:

    history.back();
    window.history.back();
    Zweitfenster.history.back();
    parent.frames[2].history.back();

### Erläuterung:

Methoden des history-Objekts können Sie mit `history` aufrufen, die zuletzt besuchte Seite beispielsweise mit `history.back()`. Sie können auch `window.history.back()` notieren. Da es sich dabei aber um den Inhalt 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.

## length

Speichert die Anzahl der Einträge in der History für ein Fenster.

### Beispiel:

    <a href="javascript:alert(history.length)">Anzahl besuchter Seiten;</a>

### Erläuterung:

Das Beispiel definiert einen Verweis, bei dessen Anklicken die Anzahl der besuchten Seiten mit alert() ausgegeben wird.

## back()

Lädt die WWW-Seite, die zuletzt besucht wurde. Erwartet keine Parameter.

### Beispiel:

    <a href="javascript:history.back()">zur&uuml;ck</a>

### Erläuterung:

Das Beispiel definiert einen Verweis, bei dessen Anklicken die zuletzt besuchte Seite wieder aufgerufen wird.

## forward()

Lädt die WWW-Seite, die als nächste besucht wurde, sofern zuvor ein Back-Vorgang stattfand. Erwartet keine Parameter.

### Beispiel:

    <a href="javascript:history.forward()">wieder vor</a>

### Erläuterung:

Das Beispiel definiert einen Verweis, bei dessen Anklicken die Seite aufgerufen wird, die aktiv war, bevor der Anwender einen Back-Vorgang auslöste.

## go()

Springt so viele Seiten in der gespeicherten History vor oder zurück wie gewünscht. Erwartet als Parameter die Anzahl der zu springenden Seiten. Ein negativer Wert springt rückwärts (so viele Back-Vorgänge wie angegeben), ein positiver Wert springt vorwärts (so viele Forward-Vorgänge wie angegeben).

### Beispiel:

    <a href="javascript:history.go(-3)">3 Seiten zur&uuml;ck</a>

### Erläuterung:

Das Beispiel definiert einen Verweis, bei dessen Anklicken drei Seiten in der gespeicherten Historie der besuchten Seiten zurückgesprungen wird.

weiter: | location
zurück: | event

SELFHTML/Quickbar JavaScript Objekt-Referenz

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