jQuery UI API - Widget Datepicker

Catégorie

Widgets

Utilisation

Description :Sélectionnez une date dans une fenêtre contextuelle ou un calendrier intégré.

Version ajoutée :1.0

Le Datepicker de jQuery UI est un plugin hautement configurable qui ajoute une fonctionnalité de sélecteur de date à vos pages. Vous pouvez personnaliser le format de date et la langue, restreindre la plage de dates sélectionnables, et ajouter des boutons et d'autres options de navigation.

Par défaut, le datepicker s'ouvre dans une petite superposition lorsque le champ de texte associé reçoit le focus. Pour un calendrier intégré, attachez simplement le datepicker à un div ou un span.

Interaction au clavier

Lorsque le sélecteur de date est ouvert, les commandes clavier suivantes sont disponibles :

  • PAGE UP : Passer au mois précédent.
  • PAGE DOWN : Passer au mois suivant.
  • CTRL+PAGE UP : Passer à l'année précédente.
  • CTRL+PAGE DOWN : Passer à l'année suivante.
  • CTRL+HOME : Passer au mois en cours. Si le sélecteur de date est fermé, ouvrez-le.
  • CTRL+GAUCHE : Passer au jour précédent.
  • CTRL+DROITE : Passer au jour suivant.
  • CTRL+HAUT : Passer à la semaine précédente.
  • CTRL+BAS : Passer à la semaine suivante.
  • ENTRÉE : Sélectionner la date ayant le focus.
  • CTRL+FIN : Fermer le sélecteur de date et effacer la date.
  • ÉCHAP : Fermer le sélecteur de date sans effectuer de sélection.

Fonctions utilitaires

$.datepicker.setDefaults( settings )

Modifier les paramètres par défaut de tous les sélecteurs de date.

Utilisez laoption()méthode pour modifier les paramètres d'instances individuelles.

Exemples de code :

Configurer tous les sélecteurs de date pour qu'ils s'ouvrent lorsqu'ils reçoivent le focus ou lorsqu'on clique sur une icône.

$.datepicker.setDefaults({
  showOn: "both",
  buttonImageOnly: true,
  buttonImage: "calendar.gif",
  buttonText: "Calendar"
});

Définissez tous les sélecteurs de date pour qu'ils aient du texte en français.

$.datepicker.setDefaults( $.datepicker.regional[ "fr" ] );

$.datepicker.formatDate( format, date, settings )

Formater une date en une valeur de chaîne avec un format spécifié.

Le format peut être une combinaison des éléments suivants :

  • d - jour du mois (sans zéro devant)
  • dd - jour du mois (deux chiffres)
  • o - jour de l'année (sans zéro devant)
  • oo - jour de l'année (trois chiffres)
  • D - nom court du jour
  • DD - nom long du jour
  • m - mois de l'année (sans zéro devant)
  • mm - mois de l'année (deux chiffres)
  • M - nom court du mois
  • MM - nom long du mois
  • y - année (deux chiffres)
  • yy - année (quatre chiffres)
  • @ - horodatage Unix (ms depuis 01/01/1970)
  • ! - horloge Windows (100ns depuis 01/01/0001)
  • '...' - texte littéral
  • '' - guillemet simple
  • Tout le reste - texte littéral

Il y a aussi quelques$.datepickerformats de date standard prédéfinis :

  • ATOM - 'yy-mm-dd' (identique à RFC 3339/ISO 8601)
  • COOKIE - 'D, dd M yy'
  • ISO_8601 - 'yy-mm-dd'
  • RFC_822 - 'D, d M y' (voir RFC 822)
  • RFC_850 - 'DD, dd-M-y' (voir RFC 850)
  • RFC_1036 - 'D, d M y' (voir RFC 1036)
  • RFC_1123 - 'D, d M yy' (voir RFC 1123)
  • RFC_2822 - 'D, d M yy' (voir RFC 2822)
  • RSS - 'D, d M y' (identique à RFC 822)
  • TICKS - '!'
  • TIMESTAMP - '@'
  • W3C - 'yy-mm-dd' (identique à ISO 8601)
Exemples de code :

Affiche une date au format ISO. Produit "2007-01-26".

$.datepicker.formatDate( "yy-mm-dd", new Date( 2007, 1 - 1, 26 ) );

Affiche une date au format français étendu. Produit "Samedi, Juillet 14, 2007".

$.datepicker.formatDate( "DD, MM d, yy", new Date( 2007, 7 - 1, 14 ), {
  dayNamesShort: $.datepicker.regional[ "fr" ].dayNamesShort,
  dayNames: $.datepicker.regional[ "fr" ].dayNames,
  monthNamesShort: $.datepicker.regional[ "fr" ].monthNamesShort,
  monthNames: $.datepicker.regional[ "fr" ].monthNames
});

$.datepicker.parseDate( format, value, settings )

Extrait une date à partir d'une valeur de chaîne avec un format spécifié.

Le format peut être une combinaison des éléments suivants :

  • d - jour du mois (sans zéro devant)
  • dd - jour du mois (deux chiffres)
  • o - jour de l'année (sans zéro devant)
  • oo - jour de l'année (trois chiffres)
  • D - nom court du jour de la semaine
  • DD - nom long du jour de la semaine
  • m - mois de l'année (sans zéro devant)
  • mm - mois de l'année (deux chiffres)
  • M - nom court du mois
  • MM - nom long du mois
  • y - année (deux chiffres)
  • yy - année (quatre chiffres)
  • @ - horodatage Unix (ms depuis 01/01/1970)
  • ! - horloge Windows (100ns depuis 01/01/0001)
  • '...' - texte littéral
  • '' - guillemet simple
  • Tout le reste - texte littéral

Quelques exceptions qui peuvent être levées :

  • 'Invalid arguments' - levée si le format ou la valeur est vide.
  • 'Missing number at position nn' - levée si le format indique un nombre qui est introuvable.
  • 'Unknown name at position nn' - levée si le format indique un nom de jour de la semaine ou de mois qui est introuvable.
  • 'Unexpected literal at position nn' - levée si le format indique une valeur littérale qui est introuvable.
  • 'Invalid date' - levée si la date est invalide, par exemple '31/02/2007'.
Exemples de code :

Extrait une date au format ISO.

$.datepicker.parseDate( "yy-mm-dd", "2007-01-26" );

Extraire une date au format français étendu.

$.datepicker.parseDate( "DD, MM d, yy", "Samedi, Juillet 14, 2007", {
  shortYearCuroff: 20,
  dayNamesShort: $.datepicker.regional[ "fr" ].dayNamesShort,
  dayNames: $.datepicker.regional[ "fr" ].dayNames,
  monthNamesShort: $.datepicker.regional[ "fr" ].monthNamesShort,
  monthNames: $.datepicker.regional[ "fr" ].monthNames
});

$.datepicker.iso8601Week( date )

Déterminer la semaine de l'année pour une date donnée : 1 à 53.

Cette fonction utilise la définition ISO 8601 d'une semaine : une semaine commence le lundi, et la première semaine de chaque année contient le 4 janvier. Cela signifie qu'au plus trois jours de l'année précédente peuvent être inclus dans la première semaine de l'année en cours, et qu'au plus trois jours de l'année en cours peuvent être inclus dans la dernière semaine de l'année précédente.

Cette fonction est lacalculateWeekimplémentation par défaut de l'option.

Exemples de code :

Trouver la semaine de l'année pour une date.

$.datepicker.iso8601Week( new Date( 2007, 1 - 1, 26 ) );

$.datepicker.noWeekends

Définir une fonction telle que beforeShowDay pour empêcher la sélection des week-ends.

Nous pouvonsbeforeShowDayfournir dans l'optionnoWeekends()une fonction pour calculer tous les jours ouvrés, fournissant untrue/falsetableau de valeurs pour indiquer si la date est sélectionnable.

Exemples de code :

Configurez le Datepicker afin que les week-ends ne soient pas sélectionnables.

$( "#datepicker" ).datepicker({
  beforeShowDay: $.datepicker.noWeekends
});

Limites

Le datepicker prend en charge la localisation du contenu pour s'adapter à différentes langues et formats de date. Chaque localisation est contenue dans un fichier avec le code de langue ajouté au nom, par exemple, le français estjquery.ui.datepicker-fr.js. Le fichier de localisation requis doit être inclus après le code principal du datepicker. Chaque fichier de localisation ajoute ses propres paramètres à la collection de localisations disponibles, et toutes les instances appliquent automatiquement ces paramètres par défaut.

$.datepicker.regionalLa propriété contient un tableau de localisations, indexé par code de langue, avec la clé par défaut étant"", qui représente l'anglais. Chaque entrée est un objet avec les propriétés suivantes :closeText、prevText、nextText、currentText、monthNames、monthNamesShort、dayNames、dayNamesShort、dayNamesMin、weekHeader、dateFormat、firstDay、isRTL、showMonthAfterYearetyearSuffix。

Vous pouvez restaurer la localisation par défaut avec le code suivant :

$.datepicker.setDefaults( $.datepicker.regional[ "" ] );

Vous pouvez remplacer le datepicker pour une locale spécifique avec le code suivant :

$( selector ).datepicker( $.datepicker.regional[ "fr" ] );

Thèmes

Le widget Datepicker utilise lejQuery UI CSS Frameworkpour définir son apparence. Si vous devez utiliser des styles spécifiques au datepicker, vous pouvez utiliser les noms de classe CSS suivants :

  • ui-datepicker: Le conteneur externe du datepicker. Si le datepicker est en ligne, cet élément aura en plus unui-datepicker-inlineclass. Si définiisRTLoption, cet élément aura en plus unui-datepicker-rtl classe。
    • ui-datepicker-header: Le conteneur d'en-tête du datepicker.
      • ui-datepicker-prev: Le contrôle pour sélectionner le mois précédent.
      • ui-datepicker-next: Le contrôle pour sélectionner le mois suivant.
      • ui-datepicker-title: Le conteneur de titre du sélecteur de date contenant le mois et l'année.
        • ui-datepicker-month: L'affichage textuel du mois. Si l'changeMonthoption est définie, il affiche un<select>élément.
        • ui-datepicker-year: L'affichage textuel de l'année. Si l'changeYearoption est définie, il affiche un<select>élément.
    • ui-datepicker-calendar: Le tableau contenant le calendrier.
      • ui-datepicker-week-end: Cellules contenant les jours de week-end.
      • ui-datepicker-other-month: Cellules pour les jours qui apparaissent dans un mois mais qui ne sont pas des jours du mois en cours.
      • ui-datepicker-unselectable: Cellules qui ne peuvent pas être sélectionnées par l'utilisateur.
      • ui-datepicker-current-day: Cellules pour la date sélectionnée.
      • ui-datepicker-today: Cellules pour la date actuelle.
    • ui-datepicker-buttonpane: Lorsque leshowButtonPaneloption est utilisée, un volet de boutons est utilisé.
      • ui-datepicker-current: Le bouton utilisé pour sélectionner la date actuelle.

Si lanumberOfMonthsoption est utilisée pour afficher plusieurs mois, des classes supplémentaires sont utilisées :

  • ui-datepicker-multi: Le conteneur le plus externe d'un sélecteur de date multi-mois. Cet élément aura en plus unui-datepicker-multi-2、ui-datepicker-multi-3ouui-datepicker-multi-4nom de classe basé sur le nombre de mois affichés.
    • ui-datepicker-group: Le sélecteur individuel au sein du groupe. Cet élément aura en plus unui-datepicker-group-first、ui-datepicker-group-middleouui-datepicker-group-lastnom de classe basé sur sa position dans le groupe.

Dépendances

Notes supplémentaires

  • Ce widget nécessite du CSS fonctionnel, sinon il ne fonctionnera pas. Si vous créez un thème personnalisé, utilisez le fichier CSS spécifique au widget comme point de départ.
  • Ce widget manipule la valeur d'un élément par programmation, donc lechangeévénement natif ne sera pas déclenché lorsque la valeur change.
  • : 不支持在<input type="date">: 创建 Datepicker,因为它会与原生选择器产生 UI 冲突。

Exemples

一个简单的 jQuery UI Datepicker。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>日期选择器部件(Datepicker Widget)演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div id="datepicker"></div>
 
<script>
$( "#datepicker" ).datepicker();
</script>
 
</body>
</html>

Autres extensions