Le champ d'affichage HTML

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Affichage HTML

Présentation du champ d'affichage HTML
Créer un champ d'affichage HTML
Caractéristiques du champ d'affichage HTML
Options de l'onglet "Général"
Options de l'onglet "Détail", zone "HTML/JavaScript"
Options de l'onglet "Détail", zone "ActiveX IE/Edge (pour compatibilité)"
Option "Autoriser le zoom" (onglet "UI' de la fenêtre de description)

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Le champ d'affichage HTML

Présentation du champ d'affichage HTML

Le champ d'affichage HTML permet d'afficher une page Web dans une application. Ainsi, en une ligne de code, sans utiliser de navigateur externe, vos applications WINDEV et WINDEV Mobile peuvent afficher une page d'un site. Ce champ est basé sur Chromium CEF.

Créer un champ d'affichage HTML

Pour créer un champ d'affichage HTML :

Sous le volet "Création", dans le groupe "Autres champs", déroulez "HTML" et sélectionnez "Affichage HTML".
Cliquez dans la fenêtre à la position où le champ doit être créé. Le champ apparaît en création.

Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.

Caractéristiques du champ d'affichage HTML

Options de l'onglet "Général"

L'onglet "Général" de la fenêtre de description du champ permet de saisir directement du code HTML ou l'adresse de la page HTML à afficher.
Remarque : Si du code HTML est saisi, ce code doit obligatoirement être compris entre les balises <HTML> et </HTML>.

Options de l'onglet "Détail", zone "HTML/JavaScript"

L'onglet "Détail" de la fenêtre de description du champ propose les options suivantes dans la zone "HTML/JavaScript" :

Interdit l'exécution des scripts JavaScript :
Cette option permet d'interdire (ou d'autoriser) l'exécution des scripts appelés depuis le code HTML du champ.
Cette option n'est pas prise en compte : l'exécution des scripts est toujours autorisée.
Si cette option est décochée, il est possible :
- d'exécuter du code Javascript dans le contexte de la page Web affichée par le champ d'affichage HTML. Il suffit pour cela d'utiliser la fonction ExécuteJS.
- d'autoriser l'exécution de procédures WLangage depuis le code Javascript via l'option "Autoriser l'appel de WLangage depuis le code HTML (fonction JavaScript WL.Execute)".
  Si cette option est sélectionnée, dans le code du HTML du champ, il suffit d'utiliser WL.Execute pour exécuter une procédure WLangage. La syntaxe à utiliser est la suivante :
  WL.Execute(<Nom procédure WLangage> [, <Paramètre 1> [, ... [, <Paramètre N>]]] )
  où :
  - <Nom procédure WLangage> correspond au nom de la procédure à exécuter.
  - <Paramètre N> correspond aux différents paramètres à passer à la procédure :
    - Nombre de paramètres :
      - entre 0 et N.
      - entre 0 et 10.
    - Type des paramètres :
      - Les paramètres de la procédure WLangage seront passés selon leur type en tant que boolean, string, number, null.
      - Les paramètres de la procédure WLangage seront toujours passés en tant que chaîne de caractères.
  Attention :
  - La procédure ne peut pas renvoyer de valeur.
  - L'appel à la procédure WLangage est non bloquant.
  Exemple :
  - Procédure WLangage
    PROCÉDURE ProcFromJS(t)
    ToastAffiche("Appelé depuis le JS : " + t)
  - Code du champ HTML :
    s est chaîne = [
    <html>
    <head>
    <title> Un exemple simple
    </title>
    <script>
    function myFunction()
    {
    WL.Execute("ProcFromJS","titaa");
    }
    </script>
    </head>
    <body>
    <h1> Voici une page HTML </h1>
    <p id="demo">Un paragraphe</p>
    <button type="button" onclick="myFunction()">Essayer</button>
    </body>
    </html>
    ]
    HTM_SansNom1 = s
Autoriser les popups :
Cette option permet d'autoriser l'ouverture de popups en JavaScript (par exemple, possibilité d'ouvrir des menus JavaScript sous forme de popups).

Options de l'onglet "Détail", zone "ActiveX IE/Edge (pour compatibilité)"

L'onglet "Détail" de la fenêtre de description du champ propose dans la zone "ActiveX IE/Edge (pour compatibilité)", l'option Utiliser l'ActiveX IE/Edge pour afficher le contenu (compatibilité). Cette option permet d'utiliser le champ d'affichage HTML via l'ActiveX d'Internet Explorer (et non plus Chromium CEF). Il est alors possible de sélectionner le moteur de rendu voulu.

Attention : Pour utiliser un Champ d'affichage HTML en mode "ActiveX IE/Edge (pour compatibilité)" :

dans une application WINDEV, il est nécessaire d'installer Internet Explorer 4 ou supérieure (version 11 conseillée) sur le poste de développement et sur le poste de déploiement de l'application. Le Champ d'affichage HTML de WINDEV est en mode Internet Explorer 7.
Pour afficher des pages WEBDEV dans ce champ, les pages WEBDEV doivent être générées en mode HTML + Edge.
dans une application en mode simulateur, il est nécessaire d'installer Internet Explorer 4 ou supérieure (version 11 conseillée) sur le poste de développement.
dans une application iOS 9.0 (et supérieur), il est nécessaire de respecter les options de sécurité. Par défaut, le champ d'affichage HTML permet d'accéder uniquement aux sites utilisant une connexion HTTPS respectant les préconisations de la société Apple. Pour accéder à d'autres sites (HTTP par exemple), il est nécessaire soit de fournir la liste des domaines correspondants, soit de désactiver la sécurité pour tous les domaines. Ces manipulations sont faites dans l'assistant de création d'une application iOS. Pour plus de détails, consultez Générer une application iOS.

Option "Autoriser le zoom" (onglet "UI' de la fenêtre de description)

L'option "Autoriser le zoom" :

permet à l'utilisateur de modifier le zoom en écartant/resserrant les doigts.
affiche des boutons de zoom.

Pour jouer des vidéos HTML 5 dans un champ d'affichage HTML :

Cochez l'option "Autoriser l'exécution des scripts" (onglet "Général" de la fenêtre de description du champ).
Activez l'accélération matériel sur la fenêtre. Pour cela, il faut éditer le manifeste de l'application.
- Dans l'assistant de génération, affichez l'étape "Configuration".
- Cliquez sur "Configuration avancée".
- Cliquer sur "Editer le manifeste".
- Déroulez le noeud "application".
- Sélectionnez le noeud "activity" correspondant à la fenêtre contenant le champ HTML.
- Ajoutez un attribut à ce noeud en lui donnant comme nom "android:hardwareAccelerated" et comme valeur "true".
- Validez les modifications
- Terminez l'assistant.

Liste des exemples associés :

Exemples complets (WINDEV) : WD Navigateur Internet simple

[ + ] Cet exemple illustre les fonctionnalités du champ HTML de WINDEV et propose un navigateur internet simplifié avec gestion de l'historique de navigation, des favoris, ...

Exemples complets (WINDEV) : WD Mail

[ + ] Cette application est un client mail complet développé en WINDEV. Il s'appuie sur les objets Email.
Ce client mail permet de récupérer et d'envoyer des emails en utilisant les protocoles POP, IMAP et SMTP.
Il est possible d'appliquer des filtres sur le courrier entrant.
L'écriture d'un email s'appuie sur le champ Editeur HTML.
L'affichage des emails utilise le champ Affichage HTML.
L'application permet de gérer plusieurs comptes emails différents.

Exemples unitaires (WINDEV) : Le Type HTMLDocument

[ + ] Cet exemple permet de montrer comment utiliser le Type WLangage HTMLDocument.

Exemples unitaires (WINDEV) : Le champ HTML

[ + ] Utilisation d'un champ HTML

Voir Aussi

Version minimum requise

Version 26

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 30/08/2023

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