DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des chaînes
  • Règles de conversion utilisées
  • Balises gérées
  • Gestion de l'alphabet
  • Limitations
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
Convertit une chaîne HTML ou un buffer HTML en chaîne texte. Pendant la conversion, les opérations suivantes sont effectuées :
  • Suppression des balises HTML,
  • Conversion des caractères spéciaux HTML,
  • Conversion des Retours Chariots (RC) en espaces,
  • Conversion des espaces multiples en espaces uniques.
Exemple
MonTexteHtml est une chaîne
MonTexteHtml = "<!--test-->&lt;b&gt;&lt;i&gt;&quot;Bonjour !&quot;&lt;/i&gt;&lt;/b&gt;"
Texte est une chaîne = HTMLVersTexte(MonTexteHtml)
// Texte vaut : "Bonjour" !
Syntaxe
<Résultat> = HTMLVersTexte(<Texte au format HTML> [, <Alphabet utilisé>])
<Résultat> : Chaîne de caractères
Texte correspondant au résultat de la conversion HTML. L'encodage des caractères utilisé est celui de l'alphabet courant de WINDEV ou WEBDEV.
<Texte au format HTML> : Chaîne de caractères ou buffer
Texte à convertir.
<Alphabet utilisé> : Constante optionnelle de type Entier
Constante identifiant l'alphabet utilisé pour l'écriture du <Texte au format HTML>. Pour plus de détails sur ces constantes, consultez Correspondance entre les langues, les sous-langues, les alphabets et les nations.
  • Si des informations sur l'alphabet utilisé sont trouvées dans le <Texte au format HTML>, ces informations sont prioritaires sur la constante spécifiée.
  • Si ce paramètre n'est pas spécifié ou si le paramètre <Texte au format HTML> ne contient aucune information sur l'alphabet, l'alphabet en cours de WINDEV/WEBDEV est utilisé (constante alphabetCourant).
AndroidWidget Android Ce paramètre n'est pas disponible
Remarques

Règles de conversion utilisées

  • Les balises HTML sont analysées afin de conserver au mieux la mise en forme dans le texte de sortie (les Retours Chariots, les espaces, les tabulations). Le formatage n'est pas conservé : gras, italique, couleurs, ...
  • N'apparaissent pas dans la sortie texte :
    • les balises HTML
    • le contenu du "header" (informations contenues dans la balise <HEAD>)
    • les commentaires
    • les textes de contrôle
    • les scripts
    • les définitions SSL
    • les styles CSS (sauf color)
    • les éléments de formulaire
  • Gestion des Retours Chariots
    • 2 Retours Chariots sont insérés pour remplacer des balises <P>, <H1> à <H6>, <TABLE>, <UL> ou <OL>
    • 1 Retour Chariot est inséré pour remplacer les balises <BR>, <TR>, <LI>, <DD> ou <DIV>
    • 1 seul Retour Chariot est inséré si plusieurs balises identiques (<TR>, <LI>, <DD> ou <DIV>) se suivent (sauf pour les balises <BR>)
  • Gestion des tableaux
    • Pour chaque ligne d'un tableau (balise <TR>), un Retour Chariot est inséré.
    • Pour chaque colonne d'un tableau (balise <TD>), une tabulation est insérée.
  • Gestion des caractères spéciaux
    Un caractère spécial est un caractère défini dans la norme HTML. Par exemple, un espace peut s'écrire "&nbsp;" et le caractère "é" peut s'écrire "&eacute,". Cette norme est automatiquement utilisée.

Balises gérées

Les balises non gérées sont ignorées : leur contenu est pris en compte comme du texte.
Les balises gérées sont les suivantes :
  • <PRE>
  • <UL> : Saut de ligne + tabulation
  • <OL> : Saut de ligne + tabulation
  • <LI> : Tabulation
  • <H1> : Saut de ligne avant et saut de ligne après
  • <H2> : Saut de ligne avant et saut de ligne après
  • <H3> : Saut de ligne avant et saut de ligne après
  • <H4> : Saut de ligne avant et saut de ligne après
  • <H5> : Saut de ligne avant et saut de ligne après
  • <H6> : Saut de ligne avant et saut de ligne après
  • <P> : Saut de ligne avant et saut de ligne après
  • <BR> : Saut de ligne
  • <DL> : Saut de ligne
  • <DT> : Saut de ligne
  • <DD> : Tabulation et saut de ligne
  • <TABLE> : Saut de ligne
  • <TR> : Saut de ligne
  • <TD> : Eléments séparés par une tabulation
  • <HEAD> : Contenu ignoré, sauf les paramètres de l'alphabet
  • <STYLE> : Contenu ignoré
  • <SCRIPT> : Contenu ignoré
  • <!-- --> : Commentaires ignorés

Gestion de l'alphabet

Pour connaître l'alphabet utilisé dans le texte HTML, la fonction HTMLVersTexte utilise l'information contenue dans l'attribut CONTENT d'une balise <META>.
Si cette balise n'est pas présente, il est nécessaire de spécifier l'alphabet utilisé pour écrire le texte HTML avec le paramètre <Alphabet utilisé>.
En effet, si le contenu HTML utilise un alphabet arabe, et si WINDEV/WEBDEV utilisent par défaut un alphabet français, le texte de sortie utilisera des caractères invalides.
Remarques :
  • Si le texte de sortie contient de nombreux caractères "?", cela signifie que le caractère de l'alphabet du document HTML n'a pas pu être exprimé avec un caractère de la langue en cours.
  • L'alphabet UTF8 est le plus couramment utilisé pour l'encodage des pages Web.
AndroidWidget Android

Limitations

Le résultat de la fonction HTMLVersTexte peut être différent de celui sous Windows. Les règles de conversion citées et la liste des balises gérées ne s'appliquent pas sous Android.
Liste des exemples associés :
Les fonctions HTMLVers Exemples unitaires (WEBDEV) : Les fonctions HTMLVers
[ + ] Utilisation des fonctions WLangage HTMLVersRTF et HTMLVersTexte.
Passage du format RTF au format HTML Exemples unitaires (WINDEV) : Passage du format RTF au format HTML
[ + ] Utilisation des fonctions RTFVersHTML et RTFVersTexte.
WD Mail 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.
Le Type HTMLDocument Exemples unitaires (WINDEV) : Le Type HTMLDocument
[ + ] Cet exemple permet de montrer comment utiliser le Type WLangage HTMLDocument.
Composante : wd290rtf.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/12/2023

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