Accès
Pour insérer un objet Champ de saisie, il faut, au choix :
Choisir l'option Objets Adélia Web Studio/Champ de saisie du menu Insertion de la fenêtre Macromedia Dreamweaver®.
Effectuer un clic sur le bouton correspondant
dans la barre d'insertion des objets Adélia de Dreamweaver®.
Cette boîte de dialogue permet de définir les différents attributs de l'objet Champ de saisie.
Général
Nom
Mot directeur Adélia de la zone.
Type
Type Adélia de la zone.
Valeurs possibles :
Alphanumérique,
Binaire court,
Binaire long,
Condensé,
Date,
Etendu,
Time,
Timestamp.
Longueur
Longueur Adélia de la zone.
Ce champ n'est visible que si le Type est Alphanumérique, Condensé ou Etendu.
Décimales
Nombre de décimales de la zone.
Ce champ n'est visible que si le type indiqué dans le champ Type est Condensé ou Etendu.
Mot d'édition
Mot d'édition définissant un masque d'affichage pour une zone numérique si la liste des codes édition est insuffisante.
Un mot d'édition ne peut pas être choisi si un code d'édition a été choisi.
Si un mot d'édition est saisi, il est soumis aux contraintes suivantes :
- la longueur du mot d'édition doit être égale à celle du type ;
- cette longueur est calculée en comptant uniquement les espaces.
Saisie facultative.
Ce champ n'est visible que si le Type est Condensé ou Etendu et qu'aucun code d'édition n'a été sélectionné.
Code d'édition
Permet d'indiquer un code correspondant à un format d'affichage de la variable. Ces codes sont disponibles dans la liste déroulante.
Un code édition ne peut être choisi si un mot d'édition a été saisi.
Cette liste n'est visible que si le Type est Condensé ou Etendu.
Contrôle de saisie
Liste des contrôles de saisie supportés par l'objet.
Le contrôle sélectionné définit le contrôle de saisie clavier.
Lors de l'exécution du programme, le contrôle de saisie permet de sélectionner un ensemble de caractères valides pour le contenu du champ de saisie lors de la frappe de l'utilisateur.
Cette liste déroulante n'est active que si le Type est Alphanumérique, Date, Condensé ou Etendu.
Styles
Actif
Case cochée |
Activation du champ de saisie. |
Case non cochée |
Désactivation du champ de saisie. Il est alors grisé et inaccessible. |
Lecture seule
Case cochée |
Le champ de saisie est en mode "lecture seule" et l'utilisateur ne peut pas y saisir de valeur. |
Lisible
Case cochée |
Les informations saisies par l'utilisateur sont visibles. |
Case non cochée |
Les informations saisies par l'utilisateur ne sont pas visibles (saisie de mot de passe). |
Multiligne
Case cochée |
Permet la présentation d'un champ de saisie sur plusieurs lignes. Les champs de saisie Li. / Co. permettent alors de spécifier le nombre de lignes/colonnes dans le champ de saisie de type multiligne. |
Obligatoire
Case cochée |
Permet de définir une zone obligatoire. Si le formulaire est soumis et qu'aucune valeur n'a été saisie, une erreur est détectée. |
Caché
Case cochée |
Le champ de saisie est caché. Ce champ correspond à une balise HTML input de type "hidden". |
Evénements
OnChange
Case cochée |
Un traitant d'événement Adélia est affecté, en réaction à une modification de la valeur. |
Réversible (menu déroulant)
Permet de définir si l'événement OnClick peut être annulé lors d'un clic sur le bouton Précédent du navigateur.
Valeurs possibles :
Réversible |
L'événement peut être annulé. |
Irréversible |
L'événement ne peut pas être annulé. |
Muet |
L'événement n'active pas le bouton Précédent du navigateur. Si ce bouton était déjà actif avant l'exécution d'un événement muet, alors un clic sur celui-ci annule le dernier événement déclenché avant l'événement muet. Un événement muet est obligatoirement un événement Ajax. |
Remarque : Cette option n'est disponible que si le programme WADELIA a été créé avec le support des boutons Précédent / Suivant du navigateur activé.
AJAX
Case cochée |
Définit un événement AJAX. |
Evénement (menu déroulant)
Permet l'ajout d'un traitant d'événement OnChange sur l'objet Champ de saisie.
Ce traitant est exécuté en réaction à une saisie dans le champ de saisie.
Remarque : l'ajout d'un traitant d'événement OnChange sur un objet Champ de saisie nommé OBJ_1 crée, dans le source L4G, lors de la sauvegarde de la page HTML, un bloc événement OBJ_1:ONCHANGE imbriqué dans le bloc objet OBJ_1, lui-même imbriqué dans le bloc GESTION EVENEMENT.
Evénement sans validation
Permet l'ajout et l'exécution d'un traitant d'événement OnChange sur l'objet Champ de saisie, sans qu'aucune vérification de la validité des zones de la page HTML ne soit effectuée.
Remarque : les variables Adélia liées aux objets graphiques de la page ne sont pas mises à jour.
Evénement de téléchargement
Permet l'ajout d'un traitant d'événement OnChange sur l'objet Champ de saisie. Cet événement est un événement avec validation qui en plus, déclenche le téléchargement des fichiers sélectionnés par l'intermédiaire d'un objet Téléchargement.
Cliquer ici pour plus d'informations sur les traitants d'événements Adélia.
Paramètres AJAX
Asynchrone
Case cochée |
Définit un événement AJAX asynchrone. Un événement asynchrone ne fige pas l'interface utilisateur. Celle-ci reste réactive pendant le traitement de l'événement sur le serveur d'application Web. |
Comportement
Définit la stratégie à suivre lors de demandes concurrentes d'exécution de cet événement.
Valeurs possibles :
Evt différent |
Fait comme s'il s'agissait de deux événements différents et s'appuie sur la règle définie pour les requêtes différentes (voir paramètre SIMULTANEOUS_DIFFERENT_REQUESTS_RULE dans Paramètres du fichier AWSAjax.properties). |
Evt précédent annulé |
Annule l'événement précédent (annule physiquement la connexion HTTP si l'événement précédent est en cours d'exécution ou le supprime de la file d'attente s'il est en attente d'exécution). |
Evt annulé |
Le second événement n'est pas pris en compte, quel que soit l'état du premier événement (en cours ou en attente). |
Horloge
Définit le temps d'attente entre deux exécutions de cet événement. La saisie d'une valeur dans ce champ signifie que l'événement est cyclique : il est automatiquement répété indéfiniment dès sa première exécution.
Les valeurs possibles pour les unités sont :
- Millisec. pour la milli-seconde,
- Seconde,
- Minute,
- Heure.
Cette valeur ne doit pas être supérieure à la durée de vie d'une session HTTP (définie dans le fichier web.xml).
Priorité
Définit la priorité de l'événement lorsqu'il est placé dans la file d'attente. Cette priorité définit l'ordre d'exécution de chaque événement dans la file d'attente.
Cette valeur doit être comprise entre REQUEST_MIN_PRIORITY et REQUEST_MAX_PRIORITY.
Si aucune valeur n'est saisie dans ce champ, la priorité vaut REQUEST_DEFAULT_PRIORITY (voir ces valeurs dans Paramètres du fichier AWSAjax.properties).
Invisible
Rend invisible l'indicateur de progression lorsque cet événement est exécuté.
Ce paramètre n'est pris en compte que si PROGRESS_INDICATOR_SHOW_ALL_STARTED_REQUEST vaut "N".
Menu contextuel
Nom du menu
Permet de lier un menu contextuel à cet objet. Il est possible de lier plusieurs objets Adélia à un même objet Menu (la propriété L4G OBJ_ORIGINE de l'objet Menu, utilisée dans un traitant d'événements d'un menu ou d'un item de menu, permet de savoir sur quel objet Adélia l'utilisateur a ouvert le menu).
Evénement
Définit l'événement Javascript qui déclenchera l'ouverture du menu contextuel associé.
Valeurs possibles :
onclick |
Déclenche l'ouverture du menu lorsque l'utilisateur clique sur le contrôle. |
oncontextmenu |
Déclenche l'ouverture du menu lorsque l'utilisateur clique sur le contrôle avec le bouton droit de la souris. Par défaut, sur cet événement, le navigateur ouvre un menu système. Pour afficher ce menu à la place du menu Adélia, appuyez sur la touche Ctrl lors du clic bouton droit. |
onmousedown |
Déclenche l'ouverture du menu lorsque l'utilisateur enfonce le bouton gauche de la souris sur le contrôle. |
onmouseover |
Déclenche l'ouverture du menu lorsque l'utilisateur survole le contrôle avec le curseur de la souris. |
onmouseup |
Déclenche l'ouverture du menu lorsque l'utilisateur relâche le bouton gauche de la souris sur le contrôle. |
Remarque : Pour une meilleure ergonomie, lorsque l'événement Javascript d'ouverture du menu est basé sur un clic de souris (oncontextmenu, onclick, onmousedown, onmouseup), la propriété "Fermeture sur clic page" définie au maquettage de l'objet Menu doit être activée.
Lorsque l'événement Javascript est basé sur un mouvement de la souris (onmouseover), cette propriété doit être désactivée.