PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • Fonctionnement
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
NavigateurHistoriqueModifie (Fonction)
En anglais : BrowserHistoryModify
Modifie les données de l'entrée courante dans l'historique de navigation. Ces données seront transmises lors d'un retour sur l'entrée courante.
Exemple
// Passe dans le plan suivant de l'application.
CELL_Principale..Plan++
// Interdit le retour sur l'affichage du plan précédent : remplace l'entrée d'historique
// Les données transmises sont simplement le numéro du plan
NavigateurHistoriqueModifie(CELL_Principale..Plan, MaPage..Titre, "#Plan" + CELL_Principale..Plan)
Syntaxe
NavigateurHistoriqueModifie(<Données> [, <Titre> [, <URL>]])
<Données> : Type des données
Etat associé à la page pour l'entrée courante de l'historique.
<Titre> : Chaîne de caractères optionnelle (avec guillemets)
Nouveau titre de la page.
Attention : ce titre est actuellement ignoré par une majorité de navigateur.
<URL> : Chaîne de caractères optionnelle (avec guillemets)
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 l'entrée courante 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.
Composante : WDJS.DLL
Voir Aussi
Version minimum requise
  • Version 23
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire