Calendar
Calendar affiche et sélectionne des dates dans un calendrier complet ou compact. Le champ appartient à l’état, à la validation et au périmètre de soumission du formulaire.
1. Cas d’utilisation
Usages courants :
- Planification et vues calendrier
- Sélection avec contexte des dates voisines
- Cellules de date ou de mois personnalisées
2. Ajouter et configurer
- Ajoutez Calendar dans la zone Fields d’une Form Section.
- Définissez un Field Key / Name stable et unique, identique à la propriété du DTO backend.
- Configurez les propriétés ci-dessous, puis Required, Help Text, Full row ou les conditions selon le besoin.
- Vérifiez la valeur initiale et la mise en page dans Design Preview, puis testez le parcours avec Validate / Submit.
3. Propriétés principales
| Propriété | Rôle |
|---|---|
| Fullscreen | Contrôle l’affichage du champ dans Design Preview et Runtime. |
| Selectable Start Date / End Date | Limite le nombre, la longueur ou la plage de valeurs. |
| Default Display Date | Définit la valeur initiale, le contenu ou le format du champ. |
| Disable Dates Before Today | Active ou désactive ce comportement. |
| Custom Date / Month Rendering | Contrôle l’affichage du champ dans Design Preview et Runtime. |
Les propriétés communes Field Key, Required, Help Text, Full row et Visible When proviennent du contrat de champ Form. Le tableau met en avant les réglages propres à Calendar.
4. Valeur du formulaire et contrat backend
Valeur soumise : Une chaîne.
"2026-08-11"
L’exemple montre uniquement la forme des données. L’API doit toujours valider le type, les limites et les autorisations du DTO métier.
5. Validation, conditions et interactions
Tous les champs peuvent utiliser Required, Visible When, Disabled When, Required When, Dependencies et Clear When Hidden. Ces conditions améliorent l’interface mais ne remplacent jamais la validation ni les autorisations du backend.
Capacités du composant : Fournit Panel Change Event et des Renderers de date/mois pour personnaliser les cellules.
6. Recommandations
Conseils : Définissez un format et une politique de fuseau horaire communs ; ne mélangez pas dates, heures locales et instants.
Revenez à la présentation de Form pour la mise en page, la validation, la soumission, les brouillons et le protocole backend.