DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Masques de saisie et d'affichage
  • Présentation
  • Masque d'affichage par défaut
  • Masques prédéfinis
  • Masques de la catégorie Texte
  • Masques de la catégorie "Texte et chiffre"
  • Masques de la catégorie "Informatique"
  • Masques de la catégorie "Numéro de téléphone"
  • Masques de la catégorie "Société/Banque"
  • Masques de la catégorie "Numéro de sécurité sociale"
  • Masques de la catégorie "Code postal"
  • Masques de la catégorie "Saisie Native HTML5"
  • Masques de saisie personnalisés
  • Masque de saisie fichier
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
Présentation
WINDEV, WEBDEV et WINDEV Mobile proposent deux types de masques :
  • les masques de saisie qui définissent les caractères pouvant être saisis dans les champs d'une fenêtre ou d'une page. Parfois, ces masques permettent également de modifier la casse (majuscule / minuscule) des valeurs affectées aux champs d'une fenêtre ou d'une page par programmation.
  • les masques d'affichage qui définissent les caractères pouvant être imprimés dans les champs d'un état.
Masque d'affichage par défaut
Dans une fenêtre, une page ou un état, par défaut, aucun masque de saisie (ou d'affichage) n'est associé à un champ de type texte. Vous pouvez au choix :
  • soit sélectionner un masque de saisie prédéfini.
  • soit créer un masque de saisie personnalisé.
Remarque : Si le champ est lié à une rubrique, la valeur enregistrée dans le fichier sera la valeur affichée.
Masques prédéfinis

Masques de la catégorie Texte

Masque sélectionnéEffets lors de la saisie dans le champEffets lors de l'affectation par programmationExemples
AucunPas de masque de saisiePas de masque d'affichage
1ère lettre en majusculeSi le premier caractère saisi est une lettre, cette lettre sera affichée en majuscule.
Tous les caractères peuvent être saisis.
Si le premier caractère est une lettre, cette lettre sera affichée en majuscule.
Tous les caractères sont autorisés.
  • Ave5a8B
  • J4-h89
Tout en majusculesToutes les lettres seront affichées en majuscules.
Tous les caractères peuvent être saisis.
Toutes les lettres seront affichées en majuscules.
Tous les caractères sont autorisés.
  • TÉ_V4L
  • 5JU6.5
Tout en minusculesToutes les lettres seront affichées en minuscules.
Tous les caractères peuvent être saisis.
Toutes les lettres seront affichées en minuscules.
Tous les caractères sont autorisés.
  • te_v4l
  • 5ju6.5
LettresSeules les lettres (majuscules ou minuscules) peuvent être saisies.Tous les caractères sont autorisés.
  • GTfrDs
  • ojTFEsD
Lettres majusculesSeules les lettres peuvent être saisies. Ces lettres seront automatiquement affichées en majuscules.
Remarque : Deux types de masques existent : avec ou sans accent.
Toutes les lettres seront en majuscules.
Tous les caractères sont autorisés.
  • GTREZS
  • POKUAS

Masques de la catégorie "Texte et chiffre"

Masque sélectionnéEffets lors de la saisie dans le champEffets lors de l'affectation par programmationExemples
ChiffresSeuls les chiffres et le caractère ' ' (espace) peuvent être saisis.Tous les caractères sont autorisés.
  • 49 862
  • 695372
Lettres + chiffresSeuls les lettres (majuscules ou minuscules) et les chiffres peuvent être saisies.Tous les caractères sont autorisés.
  • hT54Ij
  • T96Hgu
Lettres majuscules + chiffresSeuls les lettres et les chiffres peuvent être saisis.
Les lettres seront automatiquement affichées en majuscules.
Toutes les lettres seront affichées en majuscules.
Tous les caractères sont autorisés.
  • HT86I6
  • 97J8DR
Lettre puis Lettre/Chiffre
(WINDEV et WINDEV Mobile uniquement)
Le premier caractère est obligatoirement une lettre (majuscule ou minuscule), puis les autres caractères sont des lettres (majuscules ou minuscules) et/ou des chiffres.Tous les caractères sont autorisés.
  • j45B79c
  • Pr4f9V
Lettre puis lettre(MAJ)/Chiffre
(WINDEV et WINDEV Mobile uniquement)
Le premier caractère est obligatoirement une lettre en majuscule, puis les autres caractères sont des lettres en majuscules et/ou des chiffres.Tous les caractères sont autorisés.
  • G215FK
  • MN89R1
Chiffres,.+-' 'Seuls les éléments suivants peuvent être saisis :
  • les chiffres.
  • les caractères :
    • ',' (virgule),
    • '.' (point),
    • '+' (signe plus),
    • '-' (signe moins),
    • ' ' (espace).
Tous les caractères sont autorisés.
  • +586.21
  • 251.597,58
Nombre romainSeuls les lettres utilisées pour les nombres romain peuvent être saisies.Tous les caractères sont autorisés.
  • MMIX

Masques de la catégorie "Informatique"

Masque sélectionnéEffets lors de la saisie dans le champEffets lors de l'affectation par programmationExemples
Nom et chemin complet d'un fichierTous les caractères peuvent être saisis.
260 caractères maximum.
Tous les caractères sont autorisés.
260 caractères maximum.
  • C:\MesDoc\Fichier.DOC
  • \\Poste4\Test.TXT
Nom d'un fichier (sans son chemin)Tous les caractères peuvent être saisis.
260 caractères maximum.
Tous les caractères sont autorisés.
260 caractères maximum.
  • Fichier.DOC
  • Test.TXT
Adresse Email (validation syntaxique uniquement)Tous les caractères peuvent être saisis sauf :
  • '(' (parenthèse ouverte),
  • ')' (parenthèse fermée),
  • '<' (signe inférieur),
  • '>' (signe supérieur),
  • ',' (virgule),
  • ';' (point-virgule),
  • ':' (deux points),
  • '\' (anti-slash),
  • ' " ' (guillemet),
  • ' ' (espace).
Le caractère '@' ne peut être présent qu'une seule fois.
Tous les caractères sont autorisés.
  • Julie@yahoo.fr
  • Antoine@hotmail.com
Adresse Email (validation stricte du domaine)Mêmes restrictions que pour la vérification syntaxique d'une adresse email.
Vérifie la syntaxe de l'adresse email ainsi que le TLD (Top Level Domain) par rapport à la liste des TLD existants (voir fonction EmailVérifieAdresse).
Tous les caractères sont autorisés.
  • Julie@yahoo.fr
  • Antoine@hotmail.com
Adresses Emails multiples (validation syntaxique uniquement)Mêmes restrictions que pour la vérification syntaxique d'une adresse email. Les adresses doivent être séparées par le caractère ";".Tous les caractères sont autorisés.
  • Julie@yahoo.fr;Antoine@hotmail.com
Adresses Emails multiples (validation stricte du domaine)Mêmes restrictions que pour la vérification stricte d'une adresse email. Les adresses doivent être séparées par le caractère ";".Tous les caractères sont autorisés.
  • Julie@yahoo.fr;Antoine@hotmail.com
Adresse IPv4Seuls les chiffres et les points peuvent être saisis.Tous les caractères sont autorisés.
  • 192.168.0.1
Adresse IPv6Seuls les chiffres et les caractères ":" peuvent être saisis.Tous les caractères sont autorisés.
  • 0012:3153::5b32
Adresse MACSeuls les chiffres, les lettres et les caractères ":" peuvent être saisis.Tous les caractères sont autorisés.
  • 01:23:45:67:89:ab
UUID 128-bit
(en bloc)
Seuls les chiffres, les lettres peuvent être saisis.
AndroidWidget AndroidJava Non disponible.
Tous les caractères sont autorisés.
  • 29ea9852143a46a4842aca811e5f8597
UUID 128-bit
(tirets)
Seuls les chiffres, les lettres et les caractères "-" peuvent être saisis.
AndroidWidget AndroidJava Non disponible.
Tous les caractères sont autorisés.
  • 29ea9852-143a-46a4-842a-ca811e5f8597
UUID 128-bit
(accolades)
Seuls les chiffres, les lettres et les caractères "{}" et "-" peuvent être saisis.
AndroidWidget AndroidJava Non disponible.
Tous les caractères sont autorisés.
  • {29ea9852-143a-46a4-842a-ca811e5f8597}
UUID 256-bit
(en bloc)
Seuls les chiffres et les lettres peuvent être saisis.
AndroidWidget AndroidJava Non disponible.
Tous les caractères sont autorisés.
  • c5c9b31729278ad9da1efc44
    c437b7d85b57060f41e2bf
    4d0e112eadb77a6d0b

Masques de la catégorie "Numéro de téléphone"

Masque sélectionnéEffets lors de la saisie dans le champEffets lors de l'affectation par programmationExemples
Numéro de téléphoneSeuls les éléments suivants peuvent être saisis :
  • les chiffres.
  • les caractères :
    • '.' (point),
    • '-' (tiret),
    • '(' (parenthèse ouverte),
    • ')' (parenthèse fermée),
    • ' ' (espace).
Tous les caractères sont autorisés.
  • (33)4.58.69.76.21
  • 03 95 87 12 35
Numéro de téléphone françaisSeuls les éléments suivants peuvent être saisis :
  • les chiffres.
  • les caractères :
    • '.' (point),
    • '-' (tiret),
    • ' ' (espace).
La valeur saisie utilise automatiquement le format "XX.XX.XX.XX.XX".
Tous les caractères sont autorisés.
La valeur affectée utilise automatiquement le format "XX.XX.XX.XX.XX".
  • 04.58.69.76.21
  • 03.95.87.12.35
Numéro de téléphone suisseSeuls les éléments suivants peuvent être saisis :
  • les chiffres.
  • les caractères : ' ' (espace).
La valeur saisie utilise automatiquement le format "0XX XXX XX XX".
Tous les caractères sont autorisés.
La valeur affectée utilise automatiquement le format "0XX XXX XX XX".
  • 041 450 12 12
  • 051 250 22 22
Numéro de téléphone belgeSeuls les éléments suivants peuvent être saisis :
  • les chiffres.
  • les caractères : ' ' (espace).
La valeur saisie utilise automatiquement le format "0ZZ XX XX XX" ou "0Z XXX XX XX" où Z (ou ZZ) correspond à l'indicatif de zone. L'indicatif de zone correspond le plus souvent 2 chiffres, excepté dans les grandes agglomérations où seul 1 chiffre est nécessaire : Bruxelles : 2, Anvers : 3, Liège : 4, Gand : 9.
Tous les caractères sont autorisés.
La valeur affectée utilise automatiquement le format "0ZZ XX XX XX" ou "0Z XXX XX XX".
  • 04 532 12 25
  • 050 23 23 23
Numéro de téléphone canadienSeuls les éléments suivants peuvent être saisis :
  • les chiffres.
  • les caractères :
    • '-' (tiret),
    • ' ' (espace).
La valeur saisie utilise automatiquement le format "XXX CCC-CCCC" où XXX correspond au code régional et CCC-CCC au numéro local.
Tous les caractères sont autorisés.
La valeur affectée utilise automatiquement le format "XXX CCC-CCCC".
  • 403 250-350
  • 778 350-150

Masques de la catégorie "Société/Banque"

Masque sélectionnéEffets lors de la saisie dans le champEffets lors de l'affectation par programmation
Numéro de SIRENSeuls 8 chiffres peuvent être saisis. Le neuvième chiffre correspond au numéro de contrôle (calculé selon l'algorithme de Luhn). Il est automatiquement proposé.Tous les caractères sont autorisés.
Numéro de SIRET12 chiffres peuvent être saisis. Le treizième chiffre correspond au numéro de contrôle (calculé selon l'algorithme de Luhn). Il est automatiquement proposé.Tous les caractères sont autorisés.
Numéro IBANNuméro international de compte bancaire composé de 2 lettres, 2 chiffres (clé de contrôle) et du numéro de compte sur 30 chiffresTous les caractères sont autorisés.
Numéro RIB FrançaisNuméro français de compte bancaire sur 23 caractères :
  • 5 chiffres (code banque),
  • 5 chiffres (code guichet),
  • 11 chiffres ou lettres (numéro de compte),
  • 2 chiffres (clé RIB)
Tous les caractères sont autorisés.
Carte bancaire Visa ou MasterCard16 chiffres.Tous les caractères sont autorisés.
16 caractères au maximum.
Carte bancaire American Express15 chiffres.Tous les caractères sont autorisés.
15 caractères au maximum.

Masques de la catégorie "Numéro de sécurité sociale"

Masque sélectionnéEffets lors de la saisie dans le champEffets lors de l'affectation par programmationExemples
Numéro INSEE
(voir remarque ci-dessous)
Seuls les chiffres peuvent être saisis.
Le premier chiffre correspond obligatoirement à un '1' ou à un '2'.
13 chiffres au maximum.
Tous les caractères sont autorisés.
13 caractères au maximum.
  • 2790221241598
  • 1590866795412
Numéro INSEE + Clé
(voir remarque ci-dessous)
Seuls les chiffres peuvent être saisis.
Le premier chiffre correspond obligatoirement à un '1' ou à un '2'.
15 chiffres au maximum.
Tous les caractères sont autorisés.
15 caractères au maximum.
  • 279022124159875
  • 159086679541259
Les numéros d'identification utilisés par différents pays sont également disponibles en WINDEV, WINDEV Mobile et WEBDEV.

Rappel : Le numéro INSEE permet d'identifier de façon unique une personne. Ce numéro est composé :
  • du sexe (1 : Homme, 2 : Femme),
  • des deux derniers chiffres de l'année de naissance,
  • du mois de naissance,
  • du département de naissance,
  • du numéro INSEE de la commune de naissance,
  • du numéro d'ordre correspondant à l'inscription sur le registre communal des naissances.
    Le numéro INSEE peut être complété d'un nombre à deux chiffres appelé "Clé". Cette clé permet de vérifier l'exactitude du numéro INSEE.

Masques de la catégorie "Code postal"

Les numéros de code postal utilisés par différents pays sont également disponibles en WINDEV, WINDEV Mobile et WEBDEV.
WEBDEV - Code ServeurWEBDEV - Code Navigateur

Masques de la catégorie "Saisie Native HTML5"

Ces masques de saisie permettent d'utiliser les contrôles HTML 5 pour valider la saisie.
Attention : Ces masques ne sont pas gérés par tous les navigateurs et leur fonctionnement peut différer selon le navigateur utilisé.
Masque sélectionnéButEffets lors de la saisie dans le champ
E-Mail (HTML5)Saisie d'une adresse email.
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : La couleur de fond du champ indique une valeur saisie incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • Edge 38 : La couleur de fond du champ indique une valeur saisie incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • FireFox 5 : Le champ est entouré en rouge en saisie et lors de la sortie du champ tant que la valeur saisie est incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Chrome 12 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Non géré.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
E-Mails multiples (HTML5)Saisie d'adresses emails séparées par une virgule.
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : La couleur de fond du champ indique une valeur saisie incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • Edge 38 : La couleur de fond du champ indique une valeur saisie incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • FireFox 5 : Le champ est entouré en rouge en saisie et lors de la sortie du champ tant que la valeur saisie est incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Chrome 12 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Non géré
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
URL (HTML5)Saisie d'une URL.
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : La couleur de fond du champ indique une valeur saisie incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • Edge 38 : La couleur de fond du champ indique une valeur saisie incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • FireFox 5 : Le champ est entouré en rouge en saisie et lors de la sortie du champ tant que la valeur saisie est incorrecte.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Chrome 12 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Le contenu est préfixé en sortie du champ par "http://" si le protocole n'est pas indiqué dans le contenu.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Mois (HTML5)Saisie d'un mois au format AAAA_MM
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Non géré.
  • Edge 38 : Une liste permettant de saisir le mois est affichée.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec un spin permettant de modifier le mois automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Affichage d'une combo avec une flèche déroulant un calendrier.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Semaine (HTML5)Saisie d'une semaine au format AAAA-W99
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Non géré.
  • Edge 38 : Une liste permettant de saisir la semaine est affichée.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec un spin permettant de modifier la semaine automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Affichage d'une combo avec une flèche déroulant un calendrier.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Téléphone (HTML5)Saisie d'un numéro de téléphone.
Couleur (HTML5)Saisie d'une couleur HTML.
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Non géré.
  • Edge 38 : Combo avec couleur et sélecteur de couleur.
  • FireFox 5 : Non géré.
  • Chrome 12 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée, et le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec couleur dans zone d'affichage, et sélecteur de couleur si l'utilisateur clique sur la flèche.
  • Safari 5 : Lors de la validation du formulaire (submit), si la valeur saisie est incorrecte, le focus est mis sur le champ.
Attention : Dans un champ de type texte d'un état, seuls les masques prédéfinis "1ère lettre en majuscule", "Tout en majuscule" et "Tout en minuscule" sont gérés.
Masques de saisie personnalisés
Les masques personnalisés peuvent être décrits à l'aide des caractères suivants :
  • '9' : chiffre isolé
  • 'C' : chiffre ou espace
  • 'L' : lettre majuscule
  • 'l' : lettre minuscule
  • 'A' : caractère alphanumérique majuscule
  • 'a' : caractère alphanumérique minuscule
  • '?' : tout caractère
Tout autre caractère est reproduit tel quel. Il n'y a donc jamais de masque incorrect.
Attention : Les masques de saisie personnalisés sont appliqués uniquement sur les caractères saisis. Ces masques ne sont pas appliqués sur les valeurs initiales ou sur les valeurs affectées par programmation.
Remarque : Il est possible de décrire un masque numérique dans un champ texte. La valeur récupérée sera une chaîne de caractères numériques et non pas une valeur numérique.
Par exemple : Pour une plaque d'immatriculation, le masque 'CCCC LL 9A' (9A pour les départements 2A et 2B) donnera un résultat de la forme "1245 QD 34".
WEBDEV - Code Serveur Les masques de saisie personnalisés sont gérés uniquement en affichage : ils ne sont pas disponibles lors de la saisie dans le champ par l'internaute.
Masque de saisie fichier
Dans le cas d'un masque de saisie de type "chemin de fichier", une aide à la saisie de chemin de fichier peut être activée en cours d'exécution grâce à la case à cocher "Assister la saisie de chemin de fichier" en dessous du choix du masque:
Saisie assistée d'un chemin de fichier
Remarques :
  • Ce masque est disponible uniquement pour un champ de type texte.
  • Ce masque n'est pas applicable sur la valeur initiale ou sur la valeur affectée par programmation.
  • Cette option ne sera pas prise en compte si la saisie assistée sur les données est activée.
  • AndroidWidget AndroidJava Ce type de masque n'est pas disponible.
Liste des exemples associés :
Masque de saisie avancé Exemples unitaires (WINDEV) : Masque de saisie avancé
[ + ] Manipulation des masques de saisie dans WINDEV :
- Définition du format des positifs/négatifs dans un champ de saisie numérique
- Définition de l'apparence des négatifs dans un champ de saisie numérique
- Définition de l'apparence de la valeur 0 dans un champ de saisie numérique
- Utilisation d'une expression régulière pour empêcher la saisie d'autres caractères que les chiffres 1, 2, 3, 4, 5 et 6.
- Utilisation d'une expression régulière pour "réguler" la saisie d'un numéro de plaque d'immatriculation français
Version minimum requise
  • Version 9
Documentation également disponible pour…
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