Accès
Pour insérer un objet Bouton, il faut, au choix :
Choisir l'option Objets Adélia Web Studio/Bouton 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 Bouton.
Général
Nom
Identifiant du nom du bouton.
Texte
Libellé du bouton.
Le libellé ne peut pas être renseigné si la source d'une image a été saisie.
Image
Source de l'image associée au bouton.
Le bouton 
attenant ouvre une boîte dialogue permettant de sélectionner une image.
La source de l'image ne peut pas être renseignée si un libellé a été saisi.
Styles
Actif
Case cochée |
Activation du bouton. |
Case non cochée |
Désactivation du bouton. Il est alors grisé et inaccessible. |
Largeur
Permet de définir la largeur de l'image, uniquement si la source d'une image est sélectionnée.
Hauteur
Permet de définir la hauteur de l'image, uniquement si la source d'une image est sélectionnée.
Défaut
Case cochée |
Le bouton est le bouton par défaut de la page Html. |
Remarque : le bouton par défaut de la page Html est présenté avec un encadrement (filet noir).
Dans le cas où au moins un bouton avec image est placé dans la page, l'encadrement du bouton par défaut n'est plus dessiné. Si l'utilisateur a affecté un guide à une zone, le phénomène est identique car le guide positionne dans la page un bouton avec une image.
Evénements
OnClick
Case cochée |
Un traitant d'événement Adélia est affecté, en réaction à un clic sur le bouton. Cet événement est soit un événement OnClick sur le bouton, soit un événement de type pagination avant (OnRollup) ou de type pagination arrière (OnRolldown) sur la liste NomListe déclarée via la directive ::ADELIA_ROLLUP(NomListe) ou via la directive ::ADELIA_ROLLDOWN(NomListe). |
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 Bouton. Ce traitant est exécuté en réaction à un clic sur le bouton.
Remarque : l'ajout d'un traitant d'événement OnClick sur un objet Bouton 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 Bouton, 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 Bouton. 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.
Remarque : s'il y a un objet Téléchargement dans le formulaire contenant le bouton, les événements Pagination avant et Pagination arrière déclenchent le téléchargement du fichier sélectionné par l'intermédiaire de cet objet.
Pagination avant
Pagination avant est disponible si au moins un objet de type liste existe (la liste inférieure de la fenêtre n'est pas vide).
Permet l'ajout d'un traitant d'événement OnRollUp (pagination avant) sur l'objet associé de type liste (objet sélectionné dans la liste inférieure de la fenêtre).
Le traitant d'événement est exécuté en réaction à un clic sur le bouton.
Remarque : l'ajout d'un traitant d'événement OnRollUp sur un objet liste nommé LISTE_CLI crée, dans le source L4G, lors de la sauvegarde de la page HTML, un bloc événement LISTE_CLI:ONROLLUP imbriqué dans un bloc objet LISTE_CLI, lui-même imbriqué dans le bloc GESTION EVENEMENT.
Pagination arrière
Pagination arrière est disponible si au moins un objet de type liste existe (la liste inférieure de la fenêtre n'est pas vide).
Permet l'ajout d'un traitant d'événement OnRollDown (pagination arrière) sur l'objet associé de type liste (objet sélectionné dans la liste inférieure de la fenêtre).
Le traitant d'événement est exécuté en réaction à un clic sur le bouton.
Remarque : l'ajout d'un traitant d'événement OnRollDown sur un objet liste nommé LISTE_CLI crée, dans le source L4G, lors de la sauvegarde de la page HTML, un bloc événement LISTE_CLI:ONROLLDOWN imbriqué dans un bloc objet LISTE_CLI, lui-même imbriqué dans le bloc GESTION EVENEMENT.
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.
Les boutons
Ouvre une boîte de dialogue permettant d'affecter des ressources à un programme.