JavaScript : l'objet history

La position des objets history et location est spéciale, puisqu'ils n'influent pas sur le contenu du document (revoir la structure hiérarchique des objets).

Une liste des pages récemment visitées est mémorisée par le navigateur, et donc par chaque fenêtre. C'est l'objet history qui, au travers de l'objet DOM window, nous permet, par les URL des pages visitées, de naviguer vers l'avant ou vers l'arrière. Cependant, pour des raisons de confidentialités et de sécurité imposées par les navigateurs, il était impossible d'influer sur ces pages au moyen d'un script3.

Il est possible de se déplacer dans l'historique de la navigation au moyen des méthodes back(), forward(), et go().

Propriétés et méthodes

Propriétés de l'objet history 
Propriété | Valeur de retour | Description | Info |
History.length | Integer | Nombre d'éléments dans l'historique (lecture seule) | |
History.current | DOM String | Document en cours dans l'historique (lecture seule) | Obsolète |
History.next | DOM String | Document suivant dans l'historique (lecture seule) | Obsolète |
History.previous | DOM String | Document précédent dans l'historique (lecture seule) | Obsolète |
History.state | | [Non standardisé] Etat le plus haut dans les documents de l'historique de navigation (lecture seule) | |
Méthodes de l'objet history 
Méthode | Description |
History.back() | Charger l'élément précédent dans l'historique de navigation |
History.forward() | Charger l'élément suivant dans l'historique de navigation |
History.go() | Charger un élément précis dans l'historique de navigation |
History.pushState() | [Non standardisé] Insère les paramètres fournis dans la pile de l'historique de navigation |
History.replaceState() | [Non standardisé] Modifie la page la plus récente dans la pile de l'historique de navigation |

Reculer dans l'historique de navigation

Les navigateurs intègrent des boutons pour reculer (ou avancer si l'on a précédement reculé dans l'historique de navigation), mais il est possible de provoquer ces actions en JavaScript.

  1. window.history.back();

Avancer dans l'historique de navigation

  1. window.history.forward();

Aller à une page de l'historique de navigation

Il est possible de se rendre directement à un endroit précis de l'historique de navifgation en utilisant history.go(). Nous pouvons donc charger une page spécifique de l'historique de navigation, en se déplacant d'un certain nombre de positions vers l'avant (chiffre positif), ou vers l'arrière (chiffre négatif). Il s'agit donc d'un déplacement relatif, la page en cours étant la page 0.

  1. //reculer d'une page
  2. window.history.go(-1);
  3.  
  4. //avancer de deux pages
  5. window.history.go(2);

Nombre de pages de l'historique de navigation

  1. var historyCount = window.history.length;

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 19/03/2002 gemaakt, de laatste keer de 03/11/2018 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/javascript-window-history.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Notes

  1.  Document Object Model : komt overeen met « modèle d'objets de document » en français

  2.  DOM : “Document Object Model” (en français, « modèle d'objets de document ») Le DOM est la structure en arbre du contenu du document.

  3.  Modifier l'historique de navigation : Depuis HTML5, il existe history.pushState() et history.replaceState() pour ajouter des entrées ou modifier l'historique de navigation.

Inhoudsopgave Haut