DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions de gestion des pages
  • Multilingue
  • Afficher une page différente de la première page du site
  • Sécurité : Comment sélectionner la page à afficher
  • Choisir la destination
  • Attention
  • Comment depuis une page AWP passer des paramètres à une page dynamique (en mode Session) WEBDEV ?
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
Lance un site dynamique WEBDEV à partir d'une page statique ou dynamique WEBDEV. Le site dynamique à lancer doit se trouver sur le même serveur Web que le site en cours.
Exemple
// Affiche un site dynamique dans le cadre en cours
SiteDynamiqueAffiche("MONSITE")
// Affiche un site dans un nouveau navigateur redimensionnable (500x400)
// La fermeture du navigateur pourra être effectuée si le navigateur appelant est fermé
sNomSite est une chaîne = "MONSITE"
SiteDynamiqueAffiche(sNomSite, "", "", NouveauNavigateur, ...
"NOUVNAV", ONDimension + ONAscenseur, 500, 400, 0, 0, "dependent=1")
Syntaxe
SiteDynamiqueAffiche(<Site> [, <Page> [, <Paramètres HTTP> [, <Destination> [, <Nom de la fenêtre> [, <Options> [, <Largeur> [, <Hauteur> [, <Position horizontale> [, <Position verticale> [, <Paramètres Javascript>]]]]]]]]]])
<Site> : Chaîne de caractères
Nom du site WEBDEV à afficher.
<Page> : Chaîne de caractères optionnelle
Nom de la page à afficher. Si ce paramètre n'est pas spécifié ou correspond à une chaîne vide (""), la première page du site sera affichée.
<Paramètres HTTP> : Chaîne de caractères optionnelle
Paramètres à passer au site dynamique WEBDEV. Ces paramètres pourront être récupérés grâce à la fonction PageParamètre. La liste des paramètres doit être de la forme :
<Nom paramètre1>=<valeur paramètre1> [&<Nom paramètre2>=<valeur paramètre2> [...]>]
Par exemple : "param1=1&param2=texte"
Si aucun paramètre ne doit être passé au site, ce paramètre peut correspondre à une chaîne vide ("").
<Destination> : Chaîne de caractères ou constante optionnelle
Nom de la frame de destination. <Destination> peut également prendre les valeurs suivantes :
FrameEnCoursLa destination est le cadre en cours (valeur par défaut).
Ce paramètre peut également correspondre à la chaîne "_self" (compatibilité avec WEBDEV 1.5).
FrameParentLa destination est le conteneur de la page en cours (frameset parent, navigateur parent).
Ce paramètre peut également correspondre à la chaîne "_parent" (compatibilité avec WEBDEV 1.5).
NavigateurEnCoursLa destination est le navigateur en cours.
Ce paramètre peut également correspondre à la chaîne "_top" (compatibilité avec WEBDEV 1.5).
NouveauNavigateurLa destination est un nouveau navigateur (une nouvelle fenêtre de navigateur est ouverte). Les paramètres suivants de la fonction SiteDynamiqueAffiche permettent de configurer cette nouvelle fenêtre.
Ce paramètre peut également correspondre à la chaîne "_blank" (compatibilité avec WEBDEV 1.5).
<Nom de la fenêtre> : Chaîne de caractères optionnelle
Nom de la fenêtre du nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur. Ce paramètre permet de réafficher une page dans un navigateur portant le même nom (si plusieurs navigateurs sont ouverts sur le poste de l'internaute).
<Options> : Constante ou combinaison de constantes de type entier (optionnelle)
Paramètres de la fenêtre du nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur :
ONAdresseLa barre d'adresse sera affichée.
ONAscenseurLes barres de défilement seront affichées.
ONComplet
(Valeur par défaut)
La fenêtre du nouveau navigateur sera complète (équivalent à la combinaison de toutes les constantes).
ONDimensionLa fenêtre du nouveau navigateur sera redimensionnable.
ONLienLa barre des liens sera affichée.
ONMenuLa barre de menu sera affichée.
ONMessageLa barre de message sera affichée.
ONOutilsLa barre d'outils sera affichée.
ONSimpleLa fenêtre du nouveau navigateur sera minimale (aucune combinaison de constantes).
<Largeur> : Entier optionnel
Largeur en pixels de la fenêtre du nouveau navigateur.
<Hauteur> : Entier optionnel
Hauteur en pixels de la fenêtre du nouveau navigateur.
<Position horizontale> : Entier optionnel
Position horizontale en pixels de la fenêtre du nouveau navigateur (par rapport au coin haut gauche de l'écran).
<Position verticale> : Entier optionnel
Position verticale en pixels de la fenêtre du nouveau navigateur (par rapport au coin haut gauche de l'écran).
<Paramètres Javascript> : Chaîne de caractères optionnelle
Autres paramètres Javascript à utiliser lors de l'ouverture d'un nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur. Par exemple, "dependent = 1" permet de forcer la fermeture du nouveau navigateur si le navigateur en cours est fermé.
Remarques

Multilingue

La fonction SiteDynamiqueAffiche transmet automatiquement la langue en cours de la page courante au site WEBDEV à afficher. Ainsi, si la page courante est en Français (Nation(5)), le site WEBDEV sera lancé en Français.

Afficher une page différente de la première page du site

Le paramètre <Page> peut correspondre à n'importe quelle page du site. Cette page doit avoir l'option "Accessible par la fonction SiteDynamiqueAffiche" cochée dans l'onglet "Général" de la description de la page.

Sécurité : Comment sélectionner la page à afficher

Pour choisir la page du site dynamique à afficher, il est conseillé d'utiliser un mécanisme personnalisé d'identification des pages.
Pour des questions de sécurité, il est en effet déconseillé de passer directement le nom de la page à afficher en paramètre à la fonction SiteDynamiqueAffiche. Utilisez plutôt un identifiant numérique.
Exemple : Dans un code de clic navigateur d'une page :
SiteDynamiqueAffiche("Site", "", "Param=1")
Dans le code d'initialisation du site "Site" :
// Récupère le numéro de la page à afficher
NuméroPage est un entier = PageParamètre("Param")
// selon le numéro de page
SELON NuméroPage
CAS 1 : PageAffiche(PageAAfficher)
FIN
 
// Si on n'a pas précisé de page par défaut,
// on laisse s'afficher la première page du projet

Choisir la destination

Pour choisir la destination du fichier, il est conseillé d'utiliser le paramètre <Destination> de la fonction SiteDynamiqueAffiche plutôt que la fonction ChangeDestination. En effet, dans ce cas, le code Javascript correspondant est plus petit et donc la taille de vos pages est optimisée.

Attention

Bien que la fonction SiteDynamiqueAffiche soit une fonction utilisée en code Navigateur, son appel déclenche un retour au serveur. Il est donc déconseillé d'utiliser cette fonction depuis un bouton de type "Submit" ayant un code Serveur.

Comment depuis une page AWP passer des paramètres à une page dynamique (en mode Session) WEBDEV ?

La page dynamique (en mode Session) doit avoir l'option "Accessible par la fonction SiteDynamiqueAffiche" activée dans le volet "Général" de la description de cette page.
Une autre page de type AWP possède un champ Bouton ayant l'option "Lors de l'action" qui correspond à "Ne rien envoyer au serveur".
Voici un exemple de code de ce bouton :
sParametres est une chaîne
sParametres = "P1=" + LIB_P1 + "&P2=" + LIB_P2 + "&P3=" + LIB_P3
SiteDynamiqueAffiche("MONSITE", "MAPAGE", sParametres, NouveauNavigateur)
Voici un exemple de récupération de ces paramètres dans le code de déclaration de globale de la page dynamique :
nParam1 est un entier = PageParamètre("P1")
bParam2 est un booléen = PageParamètre("P2")
sParam2 est une chaîne = PageParamètre("P3")
Composante : WDJS.DLL
Version minimum requise
  • Version 9
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