SELFHTML: JavaScript / Référence objet JavaScript / history

SELFHTML/Quickbar JavaScript Référence objet

history

history: généralités sur l'utilisation

Propriétés:

length (nombre de pages visitées)

Méthodes:

back() (page précédente)
forward() (page suivante)
go() (passer à une URL dans l'historique)

history: généralités sur l'utilisation

Par l'objet history, qui se trouve dans la hiérarchie objet JavaScript sous l'objet window, Vous avez accès aux pages WWW qui ont été visitées par l'utilisateur. Déterminante pour cet accès est la liste telle qu'elle est sauvegardée dans l'historique du navigateur, accessible chez Netscape par le menu Window/history (Communicator/historique). Avec cet objet, vous pouvez par exemple construire des liens du type "retour à la dernière page visitée".

Exemples:

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

Explication:

Vous pouvez appeler les méthodes de l'objet history avec history, la dernière page visitée par exemple avec history.back(). Vous pouvez également noter window.history.back(). Étant donné qu'il s'agit là du contenu de la fenêtre actuelle, la mention du nom de fenêtre n'est pas absolument nécessaire. Il en va autrement pour l'accès à d'autres fenêtres ou à des fenêtres frames. Dans ces cas là, vous devez adresser correctement la fenêtre. Lisez pour les fenêtres additionnelles la partie sur l' utilisation de l'objet window et pour les fenêtres frames la partie sur l' utilisation de l'objet frame.

length

Sauvegarde le nombre d'éléments de l'historique pour une fenêtre.

Exemple:

<a href="javascript:alert(history.length)">nombre de pages visitées;</a>

Explication:

L'exemple définit un lien qui lorsqu'on le clique donne le nombre des pages visitées avec alert().

back()

Charge la page WWW visitée la dernière. N'attend aucun paramètre.

Exemple:

<a href="javascript:history.back()">page précédente</a>

Explication:

L'exemple définit un lien qui lorsqu'on le clique appelle à nouveau la dernière page visitée.

forward()

Charge la page WWW qui a été visitée comme page suivante dans la mesure où un retour à la page précédente a été effectué. N'attend aucun paramètre.

Exemple:

<a href="javascript:history.forward()">page suivante</a>

Explication:

L'exemple définit un lien qui lorsqu'on le clique appelle la page qui était active avant que l'utilisateur ne revint à la page précédente.

go()

Avance ou recule du nombre de pages désiré dans l'historique sauvegardé. Attend comme paramètre le nombre de pages à sauter. Un nombre négatif recule (autant de fois page précédente que mentionné), Un nombre positif avance (autant de fois page suivante que mentionné).

Exemple:

<a href="javascript:history.go(-3)">3 pages en arrière</a>

Explication:

L'exemple définit un lien qui lorsqu'on le clique recule de trois pages dans l'historique sauvegardé des pages visitées.


après:	location
avant:	event

SELFHTML/Quickbar JavaScript Référence objet