SELFHTML/Aides à la navigation JavaScript/DOM 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 URI 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 cadres. 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 cadres la partie sur l' utilisation de l'objet frame.

Attention:

JavaScript ne permet qu'un accès limité à l'objet history pour la protection des visiteurs de pages. Cela signifie que vous n'avez pas accès aux URI des adresses de pages visitées et que vous ne pouvez pas non plus effacer l'historique. Outre le déplacement dans l'historique, il est somme toute permis d'écraser l'enregistrement de la dernière page visitée dans history avec la méthode  location.replace().

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&eacute;c&eacute;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&egrave;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..

	location
	event

SELFHTML/Aides à la navigation JavaScript/DOM Référence objet

© 2001 Stefan Münz / © 2003 Traduction  Serge François, 13405@free.fr
 selfhtml@fr.selfhtml.org