datepicker

Un élément datepicker permet à l'utilisateur d'entrer une date. Trois types sont disponibles, ce qui peut être spécifié à l'aide de l'attribut type.

  • normal — un sélecteur de date avec trois champs pour entrée l'année, le mois et le jour.
  • grid — un sélecteur de date avec une grille de calendrier pour choisir une date.
  • popup — un sélecteur de date normal avec trois champs, mais avec un bouton déroulant supplémentaire pour afficher une grille dans un popup.

Plusieurs manières de définir le jour sélectionné existent. En XUL, l'attribut value peut être défini à une valeur de la forme AAAA/MM/JJ pour initialiser le sélecteur de date à une certaine date. S'il n'est pas spécifié, il affichera par défaut le jour actuel.

Pour changer la date sélectionnée, la propriété value peut être utilisée pour définir une nouvelle valeur de la forme AAAA/MM/JJ. La propriété dateValue peut être utilisée pour obtenir et définir la date à l'aide d'un objet Date. En outre, les propriétés date, month et year peuvent être utilisées pour obtenir et modifier chaque composant de la date séparément.

Attributs
disabled, firstdayofweek, readonly, type, tabindex, value
Propriétés
date, dateLeadingZero, dateValue, disabled, month, monthLeadingZero, open, readOnly, tabIndex, value, year, yearLeadingZero

Exemples

Image:Controlsguide-datepicker-grid.png

<datepicker type="grid" value="2007/03/26"/>

Attributs

disabled
Type : booléen
Indique si l'élément est ou non désactivé. Si cette valeur est définie à true, l'élément est désactivé. Les éléments désactivés sont habituellement affichés avec leur texte grisé. Si l'élément est désactivé, il ne répond pas aux actions de l'utilisateur, il ne peut pas recevoir le focus, et l'évènement command ne se déclenchera pas.


Image:XUL_ref_attr_disabled.png
<!-- La case à cocher active/désactive le bouton -->
<checkbox label="Enable button" 
    onclick="document.getElementById('buttRemove').disabled = this.checked"/>
<button id="buttRemove" label="Remove All" disabled="true"/>
firstdayofweek
Type : entier
Indique le jour de la semaine à afficher comme premier jour dans la grille. Les valeurs vont de 0 à 6, où 0 est dimanche et 6 est samedi. La valeur par défaut est déterminée par la locale, n'utilisez donc cet attribut que si vous désirez l'écraser.


readonly
Type : booléen
Si défini à true, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script.
tabindex
Type : entier
L'ordre de tabulation de l'élément. L'ordre de tabulation est l'ordre dans lequel le focus se déplace lorsque l'utilisateur appuie sur la touche « tab ». Les éléments dont le tabindex est plus haut se trouvent plus tard dans la séquence de tabulation.
type
Type : une des valeurs suivantes
L'attribut type peut avoir l'une des valeurs ci-dessous afin de spécifier le type de sélecteur de date à utiliser :
  • normal : Un sélecteur de date avec trois champs pour entrer l'année, le mois et le jour. C'est la valeur par défaut, il ne faut donc pas spécifier l'attribut type si c'est le genre désiré.
  • grid : Un sélecteur de date qui affiche une grille de calendrier où un mois est affiché à la fois.
  • popup : Un sélecteur de date avec trois champs d'entrée mais un bouton déroulant supplémentaire qui, lorsqu'on clique dessus, affichera une grille de calendrier.

 

value
Type : chaîne
La valeur initiale du sélecteur de date sous la forme AAAA/MM/JJ.

Propriétés

date
Type : entier
Le jour du mois actuellement sélectionné, entre 1 et 31. Modifiez cette propriété pour changer la date sélectionnée.
dateLeadingZero
Type : booléen
Une valeur en lecture seule indiquant si un zéro doit être affiché avant la date lorsqu'elle est inférieure à 10.
dateValue
Type : Date
La date actuellement entrée ou sélectionnée dans le sélecteur de date sous la forme d'un objet Date.
disabled
Type : booléen
Obtient et définit la valeur de l'attribut disabled.
month
Type : entier
Le mois actuellement sélectionné entre 0 (janvier) et 11 (décembre). Définissez cette propriété pour changer le mois sélectionné.
monthLeadingZero
Type : booléen
Une valeur en lecture seule indiquant si un zéro doit être affiché devant le mois s'il est inférieur à 10.
open
Type : booléen
Pour les sélecteurs de date de type popup, spécifie si celui-ci est ouvert. Définissez cette propriété pour ouvrir ou fermer le popup. Pour les autres types de sélecteurs de date, cette propriété est toujours à false.
readonly
Type : booléen
Si définie à true, l'utilisateur ne peut pas modifier la valeur de l'élément.
Cette propriété toute en minuscules n'est utilisée qu'avec l'élément preference et sera peut-être renommée en readOnly dans des versions ultérieures. D'autres éléments utilisent la propriété readOnly. L'attribut correspondant est cependant readonly en minuscules.
tabIndex
Type : entier
Obtient et définit la valeur de l'attribut tabindex.
value
Type : chaîne
La date actuellement sélectionnée au format AAAA/MM/JJ. Contrairement à la propriété month, les mois varient ici dans l'intervalle 01 à 12. Définissez cette propriété pour changer la date sélectionnée.
year
Type : entier
L'année actuellement sélectionnée entre 1 et 9999. Définissez cette propriété pour changer la date sélectionnée.
yearLeadingZero
Type : booléen
Une valeur en lecture seule indiquant si un zéro doit être affiché devant l'année si elle est inférieure à 1000.

Méthodes

Héritées de XUL element
blur, click, doCommand, focus, getElementsByAttribute

Héritées de DOM element
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

Sujets liés

Interfaces
nsIDOMXULControlElement

Étiquettes et contributeurs liés au document

Étiquettes :
Contributeurs ayant participé à cette page : BenoitL, lmorchard, Mgjbot
Dernière mise à jour par : Mgjbot,