DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions de gestion du navigateur
  • Fonctionnement
  • Empêcher l'utilisation de la touche "Précédent" du navigateur
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Ajoute une entrée dans l'historique de navigation en lui associant des données. Ces données seront transmises lors du retour sur cette entrée.
Exemple
// Passe dans le plan suivant de l'application
CELL_Principale.Plan++
// Ajoute une entrée d'historique
// Les données transmises sont simplement le numéro du plan
NavigateurHistoriqueAjoute(CELL_Principale.Plan, MaPage.Titre, "#Plan" + CELL_Principale.Plan)
Syntaxe
NavigateurHistoriqueAjoute(<Données> [, <Titre> [, <URL>]])
<Données> : Type des données
Etat associé à la page pour la nouvelle entrée de l'historique.
<Titre> : Chaîne de caractères optionnelle
Nouveau titre de la page.
Attention : ce titre est actuellement ignoré par une majorité de navigateur.
<URL> : Chaîne de caractères optionnelle
Nouvelle URL qui sera affichée par le navigateur. Cette URL est utilisée uniquement pour l'affichage dans la barre d'adresse. Il n'est donc pas nécessaire de mettre une URL valide. En revanche si l'utilisateur copie cette URL et l'utilise dans un autre navigateur, si l'URL n'est pas valide, le chargement de la page échouera.
Remarques

Fonctionnement

Les données ajoutées décrivent l'état associé à la page pour la nouvelle entrée de l'historique.
Si l'internaute retourne en arrière dans l'historique et revient sur une entrée mémorisée dans l'historique, les données mémorisées seront transmises à l'événement "Déplacement dans l'historique de navigation" (événement optionnel de la page). Cet événement doit les traiter pour restaurer l'état de la page. Cet événement doit être associé à une procédure qui attend en paramètre les données transmises :
// Evénement "Déplacement dans l'historique de navigation (onpopstate)"
PROCEDURE <NomProcédure>(<Données>)
Exemple : Cet exemple ajoute la page dans l'historique et mémorise l'heure d'insertion. Le retour sur la page précédente de l'historique affiche l'heure.
x est un Variant
x.Heure = HeureSys()
NavigateurHistoriqueAjoute(x, MaPage.Titre, "#avant") 

x.Heure = HeureSys()
NavigateurHistoriqueAjoute(x, MaPage.Titre, "#apres")
// Evénement "Déplacement dans l'historique de navigation (onpopstate)" 
PROCÉDURE TraitementHistorique(stEtat)
Info(stEtat.Heure)
Remarque : Selon les navigateurs, l'événement "Déplacement dans l'historique de navigation (onpopstate)" est également exécuté au chargement de la page et lors d'un retour à l'affichage initial de la page. Dans ce cas, le paramètre <Données> transmis à l'événement correspond à Null.

Empêcher l'utilisation de la touche "Précédent" du navigateur

Il est possible d'empêcher l'utilisation de la touche "Précédent" du navigateur. Pour plus de détails, consultez Empêcher l'utilisation de la touche "Précédent" du navigateur.
Composante : WDJS.DLL
Version minimum requise
  • Version 23
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale