La méthode jsFF.addDatePicker(identifiant, options) permet de transformer un champ texte (<input type="text">) en composant calendrier interactif.
Elle prend 2 arguments :
identifiant(obligatoire) est l'identifiant de l'élément INPUT à transformer.
options est un objet permettant de personaliser les paramètres d'affichage et de fonctionnement du calendrier. Il s'agit de :
locale : la langue utilisée (par défaut, c'est la locale de jSFF qui est transmise).
InputMode : une chaine de caractàres qui peut prendre les valeurs 'TextBox' pour avoir la date sous forme textuelle,
soit à 'Composite'(Attention : fonctionnalité bugguée à ce jour !) pour
gérer la date à l'aide de 3 champs séparés qui devront être nommés , identifiant_month et
identifiant_day, où identfiant est le premier paramàtre fourni à la fonction..
Par défaut, ce tte option est fixée à 'TextBox'.
FromYear : représente l'année de départ du calendrier. Par défaut, il s'agira de l'année 2000.
UpToYear : représente l'année de départ du calendrier. Par défaut, il s'agira de l'année 2019.
PositionMode : Cette option permet de spécifier la position du calendrier par rapport au contrôle. Elle peut prendre soit la
valeur 'Bottom' pour afficher le calendrier en dessous du contrôle, soit la valeur 'Top' auquel cas, il sera
affiché au dessus du contrôle.
afterSelect : Cette option permet de spécifier une fonction de rappel qui sera appelée lors de la sélection d'une date dans le calendrier.
Cette fonction retourne 2 paramètres : dateSel et obj représentant, respectivement, une chaine représentant la date sélectionnée
(dans le format courant du calendrier), ainsi que l'objet (INPUT) chargé de controler les calendrier.
Quelques exemples :
Un calendrier dans un champ de saisie texte circonscrit aux années 2009 à 2012 sera initialisé par
En spécifiant l'option showLegend: true, et à la condition qu'au moins un des champs legende soit renseigné dans les options, un tableau récapitulatif sera affiché en bas du composant.