|
|
|
|
- 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
Traitements associés à un champ d'affichage HTML
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énement | Condition d'exécution |
---|
Initialisation | Exécuté à l'ouverture de la fenêtre. * | Clic sur un lien | Exé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. Exemple de code :
PROCÉDURE ClicLien(sUrl est chaîne, bDansNouvelleFenetre est un booléen,
sDestination est une chaîne)
SI bDansNouvelleFenetre ALORS
AfficheNouveauNavigateur(sUrl)
RENVOYER Faux
SINON
RENVOYER Vrai
FIN
PROCÉDURE INTERNE AfficheNouveauNavigateur(sParamUrl) <délai=10ms>
<COMPILE SI TypeConfiguration = Android OU TypeConfiguration = iOS>
OuvreFenêtreMobile(FEN_POPUP, sParamUrl)
<SINON>
OuvreFille(FEN_POPUP, sParamUrl)
<FIN>
FIN
| Avant chargement de la page HTML | Exé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 HTML | Exé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 : - Sous le volet "Fenêtre", dans le groupe "Ordre", cliquez sur "Initialisation".
- Dans la fenêtre qui s'affiche, utilisez les flèches situées sur la droite pour modifier l'ordre d'initialisation des champs.
Nouveauté 2024Evé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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|