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.