ASP:CALENDAR |
ASP : Calendrier |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:Calendar paramètres> </asp:Calendar> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| Caption=valeur | Ce paramètre permet d'indiquer le titre du calendrier. | ||
| CaptionAlign=valeur | Ce paramètre permet d'indiquer l'alignement du calendrier : | ||
| Constante | Description | ||
| "Bottom" | Cette constante permet d'indiquer que le calendrier est aligné vers le bas. | ||
| "Left" | Cette constante permet d'indiquer que le calendrier est aligné vers la gauche. | ||
| "Right" | Cette constante permet d'indiquer que le calendrier est aligné vers la droite. | ||
| "Top" | Cette constante permet d'indiquer que le calendrier est aligné vers le haut. | ||
| CellPadding=valeur | Ce paramètre permet d'indiquer l'espace d'empattement d'une cellule. | ||
| CellSpacing=valeur | Ce paramètre permet d'indiquer l'espacement entre les cellules. | ||
| ID=valeur | Ce paramètre permet d'indiquer l'identificateur de la balise. | ||
| runat=valeur | Ce paramètre permet d'indiquer où doit être exécuté la balise : | ||
| Constante | Description | ||
| "server" | Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur. | ||
| ... | ... | ||
Description
Cette balise permet de définir un contrôle de calendrier.
Remarques
- Le contrôle <asp:Calendar> permet d'afficher un calendrier interactif côté serveur, offrant une interface graphique pratique pour la sélection de dates. Il est particulièrement utile pour des applications nécessitant une saisie de date intuitive, comme les systèmes de réservation ou de gestion d'événements.
- Grâce au paramètre Caption, on peut afficher un titre personnalisé au-dessus du calendrier. Cela améliore l'ergonomie en précisant à l'utilisateur la finalité du calendrier (exemple : "Choisissez votre date de départ").
- Le paramètre CaptionAlign permet de positionner le titre du calendrier selon plusieurs options : Top, Bottom, Left ou Right. Cette flexibilité permet d'adapter l'affichage du calendrier à la maquette graphique du site.
- Les propriétés CellPadding et CellSpacing permettent de contrôler respectivement l'espace à l'intérieur des cellules du calendrier, et l'espacement entre elles. Ces réglages sont importants pour obtenir une présentation claire et esthétique.
- La propriété runat="server" est obligatoire pour que le contrôle fonctionne correctement dans une page ASP.NET Web Forms. Elle permet à ASP.NET d'interpréter la balise en tant que composant serveur, capable d'interagir avec le code-behind.
- Le contrôle expose un événement SelectionChanged se déclenchant lorsqu'un utilisateur sélectionne une date. Cet événement peut être utilisé pour exécuter un traitement spécifique, comme filtrer des données en fonction de la date choisie.
- Il est possible de personnaliser l'apparence des jours, des week-ends, des jours sélectionnés ou des dates spéciales à l'aide des styles DayStyle, WeekendDayStyle, SelectedDayStyle, ou TodayDayStyle. Cela offre une grande liberté graphique.
- Le calendrier peut être configuré pour désactiver certaines dates via l'événement DayRender. Par exemple, on peut interdire la sélection de dates passées ou de jours fériés, ce qui est utile pour éviter des erreurs de saisie.
- Le contrôle Calendar permet aussi de naviguer entre les mois et les années grâce aux flèches intégrées. Il peut également être configuré pour afficher plusieurs mois à la fois en ajustant ses dimensions et styles.
- L'identifiant défini via ID est indispensable pour accéder au calendrier depuis le code-behind, que ce soit pour lire la date sélectionnée, modifier ses propriétés ou l'associer à d'autres éléments de la page.
- On peut facilement synchroniser le calendrier avec d'autres contrôles, comme une TextBox, pour afficher la date sélectionnée dans un champ de saisie. Cette interaction est courante dans les formulaires de réservation ou de planification.
- La propriété VisibleDate permet de définir le mois affiché initialement à l'ouverture du calendrier. Cela est utile lorsqu'on veut afficher directement une période future, par exemple pour une inscription à un événement lointain.
- Le calendrier peut être localisé selon la culture de l'utilisateur, ce qui permet d'adapter le nom des jours, le format des dates et le début de la semaine. Cela améliore fortement l'accessibilité dans les contextes multilingues.
- Il est également possible de restreindre les dates sélectionnables à une plage donnée en utilisant les propriétés SelectableDateStart et SelectableDateEnd. Cela est pratique pour limiter la saisie à des périodes précises.
- Le contrôle est léger et ne nécessite pas de script client pour fonctionner. Il repose entièrement sur le modèle Web Forms, avec postbacks pour chaque interaction, ce qui peut être suffisant pour des applications internes ou simples.
Exemple
Voici un exemple permettant d'afficher un calendrier :
- <%@ Page Language="vb" %>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <body>
- <form id="MonFormulaire" runat="server">
- <asp:Calendar id="MonCalendar" runat="server"></asp:Calendar>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017