Accès
Pour insérer un objet Case à cocher, il faut, au choix :
Choisir l'option Objets Adélia Web Studio/Case à cocher 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 Case à cocher.
Général
Nom
Mot directeur Adélia de la zone.
Type
Type Adélia de la zone.
Valeurs possibles :
Alphanumérique,
Booléen,
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 indiqué dans le champ 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.
Val. cochée (ISO)
Définition de la valeur associée à l'état coché.
Cette valeur doit être saisie au format ISO.
Rappel du format ISO :
Etendu/Condensé |
-xxx.xx |
Date |
YYYY-MM-DD |
Time |
HH.MM.SS |
Tms |
YYYY-MM-DD-HH.MM.SS.mmm |
Val. décochée (ISO)
Définition de la valeur associée à l'état décoché.
Cette valeur doit être saisie au format ISO.
Styles
Texte
Libellé accolé à la case à cocher.
Pos. texte
Détermine la position du libellé (texte) associé à la case à cocher.
La position est soit à droite, soit à gauche de la case à cocher.
Actif
Case cochée |
Activation de la case à cocher. |
Case non cochée |
Désactivation de la case à cocher. Elle est alors grisée et inaccessible. |
Init. coché
Détermine l'état initial de la case à cocher.
Case cochée |
Par défaut la case sera cochée. |
Liste sélection
Case cochée |
Dans le cas où la case à cocher fait partie d'une liste, détermine si l'objet est utilisé pour gérer la sélection multiple. Dans ce cas, les informations Adélia (Mot Directeur, type Adélia, longueur...) ne sont plus utiles. La case à cocher correspond à l'attribut de sélection de la liste Adélia dans laquelle elle est placée. L'identifiant (attribut name) de la case à cocher est automatiquement positionné avec la valeur « _flagsel » |
Evénements
OnClick
Case cochée |
Un traitant d'événement Adélia est affecté, en réaction à un clic sur la case à cocher. |
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 OnClick sur l'objet Case à cocher. Ce traitant est exécuté en réaction à un clic sur la case à cocher.
Remarque : l'ajout d'un traitant d'événement OnClick sur un objet Case à cocher nommé OBJ_1 crée, dans le source L4G, lors de la sauvegarde de la page HTML, un bloc événement OBJ_1:ONCLICK 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 OnClick sur l'objet Case à cocher, 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 OnClick sur l'objet Case à cocher. 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.