XUL:datepicker

Un article de MDC.

« Accueil de la référence XUL    [ Exemples | Attributs | Propriétés | Méthodes | Sujets liés ]

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

[modifier] Exemples

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

[modifier] Attributs

Hérités de XUL element align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, querytype, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

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.

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.

[modifier] Propriétés

Héritées de XUL element align, allowEvents, boxObject, builder, className, collapsed, contextMenu, controllers, currentItem, database, datasources, dir, flex, height, hidden, id, left, listBoxObject, maxHeight, maxWidth, menu, minHeight, minWidth, observes, ordinal, orient, pack, persist, ref, resource, statusText, style, tooltip, tooltipText, top, value, width Héritées de DOM element attributes, childNodes, cloneNode, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling, tagName

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, permet à l'utilisateur de modifier la valeur de l'élément.

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.

[modifier] 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

[modifier] Sujets liés

Interfaces

nsIDOMXULControlElement