Pour insérer un objet Calendrier, il faut, au choix :
- Choisir l'option Objets Adélia Web Studio/Calendrier 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 Calendrier.
Général
Nom
Mot directeur Adélia de la zone.
Type
Type Adélia de la zone.
Valeurs possibles :
Condensé 6 dont 0 décimale,
Condensé 8 dont 0 décimale,
Date,
Etendu 6 dont 0 décimale,
Etendu 8 dont 0 décimale.
Format de date
Format numérique (combinaison année, mois, jour) de la valeur de la date du calendrier.
Cet attribut n'est pris en compte que si le calendrier est lié à un contrôle Adélia et si son type Adélia est numérique (étendu ou condensé). Dans ce cas, ce format doit correspondre au format de date du contrôle.
Valeurs possibles :
Code |
Représentation |
Information |
DMY |
DDMMYY ou DDMMYYYY |
D représente la valeur du jour sur 2 chiffres. M représente la valeur du mois sur 2 chiffres. Le nombre de chiffres de l'année (Y) dépend de la longueur du type Adélia (6 ou 8). |
DYM |
DDYYMM ou DDYYYYMM |
Idem. |
YMD |
YYMMDD ou YYYYMMDD |
Idem. |
YDM |
YYDDMM ou YYYYDDMM |
Idem. |
MYD |
MMYYDD ou MMYYYYDD |
Idem. |
MDY |
MMDDYY ou MMDDYYYY |
Idem. |
Contrôle lié
Mot directeur Adélia de la zone représentée par une balise <adelia:entryfield> ou <adelia:outputfield> dont la valeur est affichée par le calendrier.
Dans ce cas, il est possible de modifier la valeur de la zone en sélectionnant une date dans le calendrier.
Type d'affichage
Type d'affichage (cadre ou fenêtre) du calendrier.
Ce champ n'est visible que si le calendrier est lié à un contrôle Adélia.
Valeurs possibles :
Code |
Représentation |
WIN |
Le calendrier est affiché dans une nouvelle fenêtre du navigateur. |
WIN_MODAL |
Le calendrier est affiché dans une nouvelle fenêtre du navigateur. Cette fenêtre est modale par rapport à la fenêtre de la page. |
DIV |
Le calendrier est affiché sous la forme d'un cadre dans la fenêtre. |
Position d'affichage
Position cardinale d'affichage du calendrier par rapport au bouton image.
Ce champ n'est visible que si le calendrier est lié à un contrôle Adélia.
Valeurs possibles :
Code |
Représentation |
CENTER |
Le calendrier est centré dans la page. |
NORTH |
Le calendrier est positionné au dessus du bouton image. |
SOUTH |
Le calendrier est positionné en dessous du bouton image. |
EAST |
Le calendrier est positionné à droite du bouton image. |
WEST |
Le calendrier est positionné à gauche du bouton image. |
NORTHEAST |
Le calendrier est positionné en haut à droite du bouton image. |
SOUTHEAST |
Le calendrier est positionné en bas à droite du bouton image. |
NORTHWEST |
Le calendrier est positionné en haut à gauche du bouton image. |
SOUTHWEST |
Le calendrier est positionné en bas à gauche du bouton image. |
Styles
Actif
Case cochée |
Activation du calendrier. |
Case non cochée |
Désactivation du calendrier. Il est impossible de modifier l'affichage du calendrier et de sélectionner une date. |
Numéro de semaine
Case cochée |
Affiche en partie gauche du calendrier les numéros de semaine du mois courant. |
Texte date du jour
Case cochée |
Affiche en partie basse du calendrier le texte de la date du jour. |
Date minimum (ISO)
Valeur de la plus petite date qu'il est possible de sélectionner par le calendrier.
Cette valeur doit être renseignée au format ISO (YYYY-MM-DD).
Date maximum (ISO)
Valeur de la plus grande date qu'il est possible de sélectionner par le calendrier.
Cette valeur doit être renseignée au format ISO (YYYY-MM-DD).
Début de semaine
Premier jour de la semaine.
Valeurs possibles :
Code |
Représentation |
MON |
Le premier jour de la semaine est le lundi. |
TUE |
Le premier jour de la semaine est le mardi. |
WED |
Le premier jour de la semaine est le mercredi. |
THU |
Le premier jour de la semaine est le jeudi. |
FRI |
Le premier jour de la semaine est le vendredi. |
SAT |
Le premier jour de la semaine est le samedi. |
SUN |
Le premier jour de la semaine est le dimanche. |
Nom des jours de semaine
Format des noms des jours de la semaine sur une ou trois lettres.
Valeurs possibles :
Code |
Représentation |
LETTER1 |
Chaque nom de jour de la semaine est représenté par la première lettre de son nom en majuscule. Par exemple, "L" pour le lundi. |
LETTER3 |
Chaque nom de jour de la semaine est représenté par son abréviation sur 3 lettres (les 3 premières). Par exemple, "lun." pour le lundi. |
Couleurs
Couleur des jours
Couleur du texte :
- de la date du jour,
- des jours du mois courant.
Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définit une valeur pour l'attribut CSS color.
Couleur du fond de mois
Couleur de fond de la zone d'affichage du mois courant.
Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définit une valeur pour l'attribut CSS background-color.
Couleur du texte du titre
Couleur du texte :
- du mois et de l'année courante,
- du jour de la date sélectionnée.
Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définit une valeur pour l'attribut CSS color.
Couleur de la barre de titre
Couleur de fond :
- de la partie haute contenant les boutons de navigation et le texte du mois et de l'année courante,
- du rond de sélection du jour de la date sélectionnée.
Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définit une valeur pour l'attribut CSS background-color.
Couleur de la ligne horizontale
Couleur de la ligne horizontale séparant les jours de la semaine des jours du mois courant.
Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définit une valeur pour l'attribut CSS border-bottom-color. Il est possible d'utiliser les autres attributs border-bottom-style et border-bottom-width. Dans ce cas, il faut faire suivre leur déclaration par la directive !important.
Couleur de la ligne verticale
Couleur de la ligne verticale séparant les numéros de semaine des jours du mois courant. Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définit une valeur pour l'attribut CSS border-right-color. Il est possible d'utiliser les autres attributs border-right-style et border-right-width. Dans ce cas, il faut faire suivre leur déclaration par la directive !important.
Couleur du texte des jours de la semaine
Couleur du texte des jours de la semaine.
Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définie une valeur pour l'attribut CSS color.
Couleur du texte des numéros de semaine
Couleur du texte des numéros de semaine du mois courant.
Cette couleur peut être définie soit :
- sous la forme d'un triplet Rouge Vert Bleu (ex : #FF0000),
- sous la forme une constante littérale HTML (ex : red),
- sous la forme d'une classe CSS qui définit une valeur pour l'attribut CSS color.
Evénements
OnChange
Case cochée |
Un traitant d'événement Adélia est affecté, en réaction à une sélection de date correspondant au clic sur un jour. Le traitant d'événement peut être soit un événement Adélia (validant le formulaire ou non), soit une expression Javascript. Si le calendrier est lié à un contrôle Adélia, la nouvelle valeur du contrôle est mise à jour avant l'exécution du traitant de l'événement. |
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 Calendrier.
Ce traitant est exécuté en réaction à une sélection de date correspondant au clic sur un jour.
Remarque : l'ajout d'un traitant d'événement OnChange sur un objet Calendrier 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 Calendrier, 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 Calendrier. 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".