Composant Web Zone de saisie

Utilisez cette option lorsque vous voulez que l'utilisateur fournisse des informations texte pour préciser par exemple son nom ou son adresse. Une zone de saisie permet à l'utilisateur d'indiquer le texte de son choix, contrairement aux composants Web tels que Zone de liste ou Case à cocher qui n'admettent que certaines valeurs. Vous pouvez également utiliser un composant Web Zone de saisie pour afficher une sortie (par exemple, si vous voulez qu'un utilisateur puisse modifier un texte envoyé en sortie à son navigateur).

Conseil : Vous pouvez déplacer par glisser-déposer une base de données IBM® i ou une zone de fichier écran depuis la vue Table IBM i de l'explorateur de systèmes éloignés vers un fichier JSP de Page Designer. Cette opération crée un composant Web Zone de saisie IBM i. Le nouveau composant Web Zone de saisie hérite du nom de zone et des attributs de données de la zone sélectionnée.

Onglet Général (iwcl:WTextEntry)

Nom
Indiquez un identificateur unique pour le composant Web IBM i. Le nom ne doit comprendre ni blancs ni traits d'union. Voir Règles concernant les valeurs et les noms des composants Web IBM i.
Type d'entrée
Les options disponibles sont Texte, Mot de passe et Masqué.
Texte
Indique que le contenu du composant Web s'affiche.
Mot de passe
Indique que le contenu du composant Web est protégé et converti sous forme d'astérisques.
Masqué
Indique que le contenu du composant Web est masqué.
Taille
Indique la largeur visible du composant Web sur la page en nombre de caractères. Il ne s'agit pas du nombre de caractères que vous pouvez entrer dans la zone, lequel peut être spécifié dans Longueur.
Etat initial
Sélectionnez Désactivé ou Lecture seule, ou les deux.
Désactivé
Indique que le composant Web n'est pas disponible.
Lecture seule
Indique que le composant Web n'est pas activé comme entrée utilisateur.
Orientation
Sélectionnez la valeur de votre choix pour définir le sens de lecture du texte et l'alignement du composant Web sur la page. Les valeurs possibles sont les suivantes : Par défaut, Droite à gauche et Gauche à droite.

Par défaut indique que le sens de lecture du texte et l'alignement du composant Web sur la page sont hérités de l'élément contenant. Par exemple, si le composant Web est inséré dans un formulaire et que le sens de lecture sélectionné pour ce formulaire est Droite à gauche, ce sens s'applique également au composant Web. La valeur par défaut est Gauche à droite.

Droite à gauche indique que le texte doit être lu de droite à gauche et que le composant Web est aligné à droite sur la page. Cette valeur remplace la valeur héritée.

Remarque : Si vous utilisez Droite à gauche alors que le formatage Code d'édition ou Mot d'édition est spécifié pour le composant, les nombres ne seront pas affichés correctement. Pour obtenir un affichage correct, spécifiez un alignement horizontal à droite dans la zone Présentation du texte du style interne.

Gauche à droite indique que le texte doit être lu de gauche à droite et que le composant Web est aligné à gauche sur la page. Cette valeur remplace la valeur héritée.

Valeur initiale
Entrez le texte initial qui apparaît dans le composant Web.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Infobulle
Entrez la description qui s'affiche lorsque le pointeur de la souris se trouve au niveau du composant Web.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Clé d'accès
Associez un caractère à une touche de raccourci pour permettre à l'utilisateur d'activer le composant Web.
Indice de tabulation
Entrez un numéro correspondant à l'ordre de tabulation du composant Web créé. Par exemple, la valeur 1 signifie que ce composant Web est le premier objet à être activé dans la séquence de tabulation.
Libellé
Entrez une légende pour le composant Web.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Position du libellé
Indiquez la position de la légende en sélectionnant Gauche ou Haut.
Gauche
Permet de positionner la légende à gauche du composant Web lorsque l'orientation est définie comme Gauche à droite. Si Droite à gauche est indiqué, la légende est placée à droite du composant Web.
Haut
Positionne la légende au-dessus du composant Web.

Onglet Données

Définition des attributs de données
Sélectionnez cette option pour définir de manière explicite le type et les attributs de données.
Type
Sélectionnez le type de données Caractère ou Numérique pour la zone d'entrée. Si vous choisissez Numérique, le bouton de formatage Définition est activé.
Longueur
Indiquez la longueur des données envoyées au programme IBM i ou renvoyées par le programme IBM i.
Positions décimales
Indiquez le nombre de positions décimales pour le type de données Numérique.
Extraction d'attributs de données d'une base de données IBM i
Sélectionnez cette option pour activer le bouton Extraction.
Extraction
Ce bouton vous permet de naviguer jusqu'à la référence de base de données sur un serveur IBM i, et d'extraire les attributs de données pour le type de données, la longueur des données, les positions décimales, le code d'édition ou le mot et le paramètre d'édition indiqués. La récupération des attributs de la zone permet l'activation du bouton Synchronisation.
Synchronisation
Ce bouton est activé lorsque les attributs de la zone ont été récupérés dans la référence de base de données de l'hôte IBM i. Si vous apportez certaines modifications aux attributs de données sur l'hôte, il vous suffit de cliquer sur le bouton Synchronisation pour mettre à jour automatiquement la vue Attributs en tenant compte de ces modifications.
Obtenir des valeurs d'environnement local à partir des :
Indique comment la valeur du symbole décimal est extraite. Les options sont les suivantes :
valeurs du système hôte
Par défaut, la valeur du symbole décimal est extraite du travail hôte DecimalFormat.
valeurs de l'environnement local du client
La valeur du symbole décimal est déterminée par l'environnement local du navigateur Web à l'exécution.
valeurs définies par l'utilisateur
Définit la valeur à utiliser comme symbole décimal dans la zone Symbole décimal. La valeur par défaut du symbole décimal est extraite de l'environnement local du système client lors de la conception.
Formatage
Lorsque le type de données est défini comme Numérique, le bouton de formatage Définition est activé. Sélectionnez Définition pour ouvrir la fenêtre Définition du formatage, où :
Aucune
Sélectionnez ce paramètre pour indiquer qu'aucun formatage n'est requis.
Code d'édition
Choisissez dans la liste un code d'édition à appliquer aux données numériques. La lettre ou le chiffre indique que l'édition doit être effectuée selon un schéma défini avant l'affichage d'une zone.
Paramètre
Sélectionnez Aucun pour indiquer qu'aucune option supplémentaire n'est associée au code d'édition. Sélectionnez Astérisque pour indiquer que des astérisques doivent être utilisés à gauche. Sélectionnez Monétaire pour qu'un symbole monétaire flottant apparaisse à gauche du premier chiffre significatif.
Modèle
Lorsque le bouton d'option Code d'édition est sélectionné, les résultats du code d'édition et du paramètre sélectionné s'affichent dans les zones Valeur positive, Valeur négative et Valeur nulle dans la zone de modèles.
Mot d'édition
Indiquez le schéma d'édition pour les données numériques. Vous pouvez spécifier :
  • les espaces,
  • les virgules et séparateurs décimaux, ainsi que leur position,
  • la suppression des zéros superflus,
  • les astérisques à gauche,
  • le symbole monétaire et sa position,
  • l'ajout de caractères constants,
  • la sortie du signe négatif, ou CR, en tant qu'indicateur négatif.
Obtenir des valeurs d'environnement local à partir des :
Indique comment le symbole décimal, le symbole monétaire, le séparateur de milliers et le séparateur de date sont appliqués lorsque vous sélectionnez Code d'édition ou Mot d'édition.
  • Lorsque vous sélectionnez valeurs du système hôte dans l'onglet Données, les valeurs du symbole décimal, du séparateur de milliers et du séparateur de date sont extraites du travail hôte. La valeur du symbole monétaire est extraite de la valeur du système hôte QCURSYM.
  • Lorsque vous sélectionnez valeurs de l'environnement local du client, les valeurs du symbole décimal, du symbole monétaire, du séparateur de milliers et du séparateur de date sont extraites de l'environnement local du navigateur Web lors de l'exécution.
  • Lorsque vous sélectionnez valeurs définies par l'utilisateur, les valeurs du symbole décimal, du symbole monétaire, du séparateur de milliers et du séparateur de date peuvent être modifiées. Les valeurs par défaut du symbole décimal, du symbole monétaire et du séparateur de milliers sont extraites de l'environnement local du système client lors de la conception. La valeur par défaut du séparateur de date est "/".
Type de valideur
Détermine les conditions de validation de la valeur saisie dans la Zone de saisie. Si la valeur saisie ne remplit pas ces conditions, un message apparaît lorsque la zone est désactivée.

Les valeurs disponibles pour une validation côté client sont les suivantes : Aucun, Comparaison ou Intervalle.

Aucune
Indique qu'aucune validation n'est effectuée.

Si vous choisissez Comparaison ou Intervalle, le bouton Définition est activé.

Lorsque Comparaison est sélectionné, le bouton Définition ouvre la fenêtre Validation par Comparaison, où :

Type de comparaison
Sélectionnez l'un des types de comparaison suivants : Aucun, égal à, différent de, inférieur à, non inférieur à, supérieur à, non supérieur à, inférieur ou égal à ou supérieur ou égal à.
Valeur de comparaison
Entrez une valeur qui permettra de comparer la valeur saisie dans la zone avec le type de comparaison indiqué.

Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.

Lorsque Intervalle est sélectionné, le bouton Définition ouvre la fenêtre Validation par comparaison, où :

Valeur minimale
Entrez une valeur minimale pour l'intervalle de validation de la valeur saisie.

Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.

Valeur maximale
Entrez une valeur maximale pour l'intervalle de validation de la valeur saisie.

Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.

Vous pouvez externaliser la valeur de comparaison ainsi que les valeurs minimale et maximale dans un fichier de propriétés pour assurer la prise en charge de différentes langues. Par exemple, une valeur numérique qui s'écrit "123.45" en anglais, s'écrira "123,45" en français, en raison du séparateur décimal défini différemment dans les paramètres régionaux des deux environnements. Par conséquent, les valeurs de validation peuvent varier d'une langue à l'autre. Vous pouvez spécifier ces valeurs dans le fichier de propriétés.

Onglet Evénements

Evénements
Dans la liste, choisissez un événement et utilisez le langage JavaScript™ pour coder l'action correspondante dans la zone Script. Par exemple, si vous sélectionnez OnBlur, vous pouvez coder le script alert ("non applicable"). Pour obtenir une brève description des événements qui s'appliquent à ce composant Web, voir Evénements du composant Web.

Onglet Styles

L'onglet Styles propose des styles internes pour le composant Web IBM i.
Style interne
Cliquez sur les boutons Polices, Styles de polices, Couleur d'arrière-plan et Présentation du texte pour ouvrir les fenêtres de définition de style respectives. Dans chaque fenêtre, sélectionnez les options que vous souhaitez appliquer au composant Web IBM i.

Informations complémentaires sur la validation

Une validation est réalisée automatiquement lorsqu'un utilisateur entre des données dans la zone de saisie et sélectionne un autre élément de la page.

Pour les données numériques, la validation est réalisée comme suit :
  • Les données sont examinées pour vérifier qu'il s'agit de données numériques correctes.
  • La longueur des données entrées par l'utilisateur est vérifiée pour contrôler qu'elle ne dépasse pas la longueur définie dans l'attribut de longueur de données.
  • Le nombre de décimales des données est vérifié pour contrôler qu'il ne dépasse pas le nombre défini dans l'attribut Décimales.
  • Un contrôle est effectué pour vérifier si les limites de validation ou la validation de la comparaison ont été spécifiées. Si tel est le cas, cette validation est également réalisée.
Pour les données de type caractères, la validation est réalisée comme suit :
  • La longueur des données entrées par l'utilisateur est vérifiée pour contrôler qu'elle ne dépasse pas la longueur définie dans l'attribut de longueur de données.
  • Un contrôle est effectué pour vérifier si les limites de validation ou la validation de la comparaison ont été spécifiées. Si tel est le cas, cette validation est également réalisée.

Un message d'erreur apparaît à chaque erreur de validation. Les messages sont enregistrés dans le fichier messages.js du projet Web. Le texte des messages peut être modifié par édition du fichier messages.js et traduit dans les langues requises.

Informations complémentaires sur le formatage

Le formatage des données est réalisé automatiquement si une valeur initiale a été définie dans la vue Attribut du composant Web, si les données ont été affectées au composant Web à l'exécution par le programme hôte ou si les données ont été entrées par l'utilisateur à l'exécution. Le formatage est réalisé par la bibliothèque de marques lors de l'exécution et avant son affichage dans la zone.

Pour les données saisies par l'utilisateur dans le navigateur, le formatage est réalisé lorsque la zone n'est plus sélectionnée. Si l'utilisateur clique à nouveau sur cette zone, elle affiche les données d'origine.


Commentaires en retour