DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Affichage HTML
  • Présentation
  • Evénements gérés par défaut
  • Evénements gérés par WINDEV et WINDEV Mobile
  • Evénements optionnels
  • Evénement optionnel : Erreur de chargement de la page
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
Traitements associés à un champ d'affichage HTML
Présentation
WINDEV et WINDEV Mobile proposent différents événements WLangage associés au Champ d'affichage HTML.
Evénements gérés par défaut

Evénements gérés par WINDEV et WINDEV Mobile

Les événements suivants sont proposés par défaut (ordre d'apparition sous l'éditeur de code) :
EvénementCondition d'exécution
InitialisationExécuté à l'ouverture de la fenêtre. *
Clic sur un lienExécuté lors du clic sur un lien présent dans le champ d'affichage HTML. Seuls les liens externes (vers une autre page) déclenchent cet événement. Les liens internes (par exemple vers une ancre de la même page) ne déclenchent pas cet événement.
Cet événement est un événement acceptant des paramètres :
PROCÉDURE ClicLien(sUrl est chaîne, bDansNouvelleFenetre est un booléen, 
sDestination est une chaîne)
où <sURL> est une chaîne de caractères optionnelle contenant l'URL du lien cliqué dans le champ d'affichage HTML.
Si cet événement renvoie Faux, l'action associée au lien ne sera pas effectuée.
Attention : le code ne doit pas comporter des traitements trop lents ou permettant au champ de reprendre le focus. En effet, dans ce cas, l'action par défaut sera tout de même effectuée.
Android Remarques :
  • Le code présent dans l'événement "Clic sur un lien" ne doit pas effectuer un traitement bloquant (comme l'affichage d'une boîte de dialogue par exemple).
  • Cet événement est exécuté uniquement à partir de la version 7.0 d'Android (Nougat).
    Rappel : Pour connaître la version du système Android sur laquelle s'exécute l'application, utilisez la fonction SysVersionAndroid.
  • Cet événement ne sera pas appelé si le lien cliqué correspond à un lien d'ancrage dans la page.
  • Seuls les clics effectués par l'utilisateur déclenchent l'appel de l'événement. Un clic "simulé" depuis du code Javascript par exemple ne provoquera pas l'appel de l'événement.
Exemple de code :
// Ouverture des liens ayant comme destination une nouvelle fenêtre, 
// dans une autre fenêtre spécifique de l'application
PROCÉDURE ClicLien(sUrl est chaîne, bDansNouvelleFenetre est un booléen, 
sDestination est une chaîne)
SI bDansNouvelleFenetre ALORS
// Ouverture d'une autre fenêtre demandée : 
// traitement d'ouverture de l'autre fenêtre, 
// décalé de façon Ã  ce que le traitement courant réponde 
// avant l'ouverture de la nouvelle fenêtre
AfficheNouveauNavigateur(sUrl)
RENVOYER Faux // Annule le comportement par défaut
SINON
RENVOYER Vrai // Laisse le comportement par défaut
FIN

PROCÉDURE INTERNE AfficheNouveauNavigateur(sParamUrl) <délai=10ms> 
// Important : mettre un délai même minime
<COMPILE SI TypeConfiguration = Android OU  TypeConfiguration = iOS>
OuvreFenêtreMobile(FEN_POPUP, sParamUrl) 
<SINON>
OuvreFille(FEN_POPUP, sParamUrl) 
<FIN>
FIN
Avant chargement de la page HTMLExécuté avant le chargement du document HTML dans le champ d'affichage HTML. Si l'utilisateur navigue par des liens dans le champ d'affichage HTML, cet événement est exécuté avant le chargement de chaque document HTML affiché dans le champ.
Cet événement est un événement acceptant des paramètres :
PROCÉDURE ChangePage(sUrl est chaîne, sDestination est une chaîne)
où <sURL> est une chaîne de caractères optionnelle contenant l'URL de la page à afficher.
Si cet événement renvoie Faux, la page ne sera pas chargée.
Après chargement de la page HTMLExécuté lors de la fin de chargement du document HTML dans le champ d'affichage HTML. Si l'utilisateur navigue par des liens dans le champ d'affichage HTML, cet événement est exécuté à la fin du chargement de chaque document HTML affiché dans le champ.
Chargement de ressources Permet d'être notifié et de bloquer le chargement d'images ou de scripts de l'application (par sécurité par exemple).
Cet événement est un événement acceptant des paramètres :
PROCÉDURE ChargementRessources(sUrl est chaîne, nType est entier)
où :
  • <sURL> est une chaîne de caractères correspondant à l'URL de la ressource à charger.
  • <nType> est une constante permettant de connaître le type de la ressource à télécharger :
    • typehtmlResImage : la ressource à télécharger est une image.
    • typehtmlResScript : la ressource à télécharger est un script.
    • typehtmlResCss : la ressource à télécharger est un style CSS.
    • typehtmlResXMLHttpRequest : la ressource à télécharger est un document XML généré en réponse à une requête HTTP.
    • typehtmlAutre : la ressource à télécharger est d'un type inconnu.
Si cet événement renvoie Faux, le chargement de la ressource ne sera pas effectué.
Clic droit sur un lien Exécuté lorsque l'utilisateur fait un clic droit sur un lien (pour ouvrir un menu contextuel). Cet événement est de la forme :
PROCÉDURE ClicDroitLien(sUrl est chaîne)
où <sURL> est une chaîne de caractères contenant l'URL du lien.

(*) Par défaut, l'événement "Initialisation" de chaque champ est exécuté selon l'ordre de création des différents champs dans la fenêtre. Pour modifier cet ordre d'exécution :
  1. Sous le volet "Fenêtre", dans le groupe "Ordre", cliquez sur "Initialisation".
  2. Dans la fenêtre qui s'affiche, utilisez les flèches situées sur la droite pour modifier l'ordre d'initialisation des champs.
Evénements optionnels
WINDEVAndroidiPhone/iPad Plusieurs événements optionnels peuvent être gérés. Pour ajouter un événement optionnel :
  1. Sélectionnez le champ voulu.
  2. Affichez la fenêtre de code de ce champ (touche F2).
  3. Cliquez sur le lien "Ajouter d'autres événements à xxx" situé à la fin de la fenêtre de code, après le dernier événement.
  4. La totalité des événements optionnels disponibles pour le champ est affichée.
  5. Cochez l'événement optionnel à ajouter et validez.
    Remarque : Il est possible de sélectionner plusieurs événements optionnels.
  6. L'événement optionnel sélectionné est automatiquement ajouté dans les événements gérés par le champ.
Pour désactiver un événement optionnel, il suffit d'effectuer les mêmes manipulations pour afficher la liste des événements optionnels. Il suffit ensuite de décocher les événements optionnels à supprimer.
Remarque : Si le code désactivé contient du code WLangage, ce code est automatiquement supprimé.
Il est ainsi possible de gérer par exemple :
  • le survol du champ par la souris,
  • le bouton gauche enfoncé, relâché, avec un double-clic,
  • le bouton droit enfoncé, relâché, avec double-clic,
  • la roulette de la souris, ...
Nouveauté 2024

Evénement optionnel : Erreur de chargement de la page

L'événement optionnel "Erreur de chargement de la page" est exécuté lorsqu'une erreur est détectée lors du chargement d'une page dans le champ. Cet événement permet d'obtenir des détails sur l'erreur rencontrée :
PROCÉDURE ErreurChargement(sUrl est chaîne, sErreur est une chaîne, nCodeErreur est un entier)
où :
  • <sURL> est une chaîne de caractères correspondant à l'URL de la ressource à charger.
  • <sErreur> est une chaîne contenant le message de l'erreur.
  • <nCodeErreur> est un entier correspondant au code de l'erreur.
Version minimum requise
  • Version 26
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/02/2024

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