Calendrier jQuery UI

Je viens de m'amuser pour la première fois avec jQuery User Interface. C'est vraiment du beau boulot! En allant de l'animation, aux effets, en plus d'ajouter les widgets et les thèmes, il y a de quoi s'amuser et créer des interfaces attrayantes en un tour de main.

Parmi les widgets disponibles, il y a :

• l'accordéon
• un sélectionneur de date (calendrier)
• une boîte de dialogue (modale)
  
• une barre de progression
• un curseur de défilement
• les onglets

Contrairement à d'autres librairies JavaScript, il faut avouer que les démos et les exemples sont bien documentés et faciles à réaliser.

Pour ma part, j'ai fait mes premières expériences avec le calendrier qui permet à l'utilisateur de sélectionner une date facilement, tout simplement parce que c'est le type de contrôle que j'utilise régulièrement dans mes formulaires. J'ai été surpris de voir à quel point celui de jQuery UI est complet. D'abord, il s'initialise facilement, il suit les règles esthétiques d'un thème qui peut se marier agréablement avec les autres contrôles et il est très flexible. Je publie ici le résultat commenté de mon premier test.

Après avoir sélectionné les options, le thème et téléchargé le tout, j'ai pris tous les fichiers et je les ai placés dans mon projet à cet emplacement : /js/jquery-ui.

Dans ma page web, j'ai chargé les librairies :

• d'abord jQuery
• ensuite le noyau UI et le datepicker
  
• l'internationalisation, pour afficher le contrôle dans la langue de notre choix
  

<script type="text/javascript" src="/js/jquery-ui/js/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="/js/jquery-ui/development-bundle/ui/ui.core.js"></script>
<script type="text/javascript" src="/js/jquery-ui/development-bundle/ui/ui.datepicker.js"></script>

Ensuite le thème de base en CSS :

<link type="text/css" href="/js/jquery-ui/development-bundle/themes/base/ui.all.css" rel="Stylesheet" />

Dans le HTML, j'ai crée un formulaire et j'y ai ajouté un champ texte, par exemple pour inscrire une date de naissance :

<input type="text" id="birthdate" />

Pour contrôler la grosseur du calendrier, j'ai dû ajuster le CSS pour réduire ses dimensions. Comme le reste du texte de ma page en était affecté, j'ai forcé la taille du texte dans différentes balises.

<style type="text/css">
body {
   font-size: 62.5%;
}

// voir plus loin
#inlineCalendar {
   font-size: 62.5%;
}

div, p {
   font-size: 12px;
   font-family: arial;
}
</style>

Pour initialiser le datepicker, j'ai créé un objet JS qui définit le format de date international (ISO 8601) du type "2008-03-29". Comme vous le verrez plus loin, d'autres options pourront être ajoutées.

var dp_config =  { dateFormat: 'yy-mm-dd' };

J'initialise le contrôle pour afficher le datepicker lorsque le champ qui possède l'ID "birthdate" recevra le focus.

function initialize() {
   $('#birthdate').datepicker(dp_config);
}

$(document).ready( initialize );

Configurer le calendrier en français

Par défaut, le calendrier s'affiche en anglais. Quelques petites modifications sont nécessaires pour le configurer en français (ou tout autre langue désirée, le répertoire d'internationalisation, i18n, semble contenir environ 40 langues prédéfinies).

// charger le fichier d'internationalisation global
<script type="text/javascript" src="/js/jquery-ui/development-bundle/ui/i18n/jquery-ui-i18n.js"></script>

// ou mieux, charger seulement la langue française
<script type="text/javascript" src="/js/jquery-ui/development-bundle/ui/i18n/ui.datepicker-fr.js"></script>

Dans l'objet dp_config, on pourra aussi redéfinir les entêtes de colonnes pour les noms de jours pour passer d'une abréviation de deux lettres à une seule :

var dp_config =
   {
       dateFormat: 'yy-mm-dd',
       dayNamesMin: ['D', 'L', 'M', 'M', 'J', 'V', 'S']
   };

Dans la fonction d'initialisation, j'ai appelé la fonction setDefaults() pour paramétrer deux éléments de langue :

• showMonthAfterYear : false, pour afficher "mars 2009" au lieu de "2009 mars"
• $.datepicker.regional['fr'] pour indiquer à i18n de charger le package de langue français
  

function initialize() {
   $.datepicker.setDefaults($.extend({showMonthAfterYear: false}, $.datepicker.regional['fr']));
   $('#birthdate').datepicker(dp_config);
}

Avec ceci, mon calendrier / datepicker était 100% fonctionnel en français.

Un peu plus d'options

En lisant la documentation, d'autres ajouts intéressants sont possibles, que j'ai placé dans dp_config (cet objet ne fait pas parti de la suite jQuery, c'est une façon que j'ai de structurer mon code pour qu'il soit plus lisible). Comme pour dateFormat et dayNamesMin, il faut ajoute une ligne à la fin pour chaque option désirée (clé/valeur, séparée par une virgule, sauf le dernier) :

• Permettre de changer de mois et/ou d'année. Comme c'est un champ pour saisir la date de naissance, on spécifiera yearRange pour permettre au calendrier de reculer 100 ans en arrière et 0 année en avant (année courante) :
  
  changeMonth: true,
  changeYear: true,
  yearRange: '-100:+0'
  
  
• Afficher deux mois consécutifs (ou plusieurs), comme le font les sites de voyage :
  
  numberOfMonths: 2
  
  
• Affichage des boutons pour revenir au mois courant et pour forcer la fermeture du datepicker :
  
  showButtonPanel: true
  
  
• Ajouter un effet graphique d'animation à l'affichage du calendrier :
  
  showAnim: 'fadeIn'
  
  
• Afficher le calendrier inline dans le HTML. Il suffit de créer une balise DIV dans le HTML et attacher le calendrier au DIV plutôt qu'au champ du formulaire dans la fonction initialize().
  
  $('#divInlineCalendar').datepicker(dp_config);