We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Element datepicker pozwala użytkownikowi na wprowadzenie daty. Trzy typy są wyświetlone, które to mogą być określone przy zastosowaniu atrybutu type.

  • normal - datepicker z trzema polami dla wprowadzenia roku, miesiąca i dnia.
  • grid - datepicker z siatką kalendarza dla zaznaczonego dnia.
  • popup - normalny element datepicker z trzema polami, lecz z dodatkowym rozwijanym przyciskiem wyświetlającym wyskakującą siatkę.

Jest tu kilka sposobów na ustawienie zaznaczenia dnia. W języku XUL wartość atrybutu może być ustawiona na wartość w formie: YYYY/MM/DD, aby inicjalizować datepicker do pewnej daty. Jeśli nie jest określona to domyślnie datepicker jest bieżącym dniem.

Aby zmienić zaznaczoną datę, wartość własności może być zastosowana do ustawienia nowej wartości w formie YYYY/MM/DD. Własność dateValue może być zastosowana do odzyskania i ustawienia daty stosując obiekt Date. W dodatku własności date, month i year mogą być zastosowane do odzyskania i modyfikacji każdego komponentu daty osobno.

Atrybuty
disabled, firstdayofweek, readonly, type, tabindex, value
Własności
date, dateLeadingZero, dateValue, disabled, month, monthLeadingZero, open, readOnly, tabIndex, value, year, yearLeadingZero

Przykład

Grafika:Controlsguide-datepicker-grid.png

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

Atrybuty

disabled
Typ: boolean
Określa, czy element jest wyłączony. Jeśli atrybut ten ma wartość true, to element będzie wyłączony. Wyłączone elementy zazwyczaj są wyszarzone. Jeśli element jest wyłączony, nie odpowiada na czynności użytkownika, nie może zostać na niego ustawiony focus, a zdarzenie command nie zostanie wywołane.
grafika:XUL_ref_attr_disabled.png
<!-- Pole wyboru włącza/wyłącza przycisk -->
<checkbox label="Enable button" 
    onclick="document.getElementById('buttRemove').disabled = this.checked"/>
<button id="buttRemove" label="Remove All" disabled="true"/>
firstdayofweek
Typ: integer
Dzień tygodnia, który jest wyświetlany jako pierwszy dzień w siatce kalendarza. Zakres wartości jest od 0 do 6, gdzie 0 jest niedzielą, a 6 jest sobotą. Domyślna wartość jest określana lokalnie, więc tylko stosujemy ten atrybut, jeśli chcemy to przesłonić.
readonly
Typ: boolean
Jeśli ustawiony jest na true, to użytkownik nie będzie mógł zmienić wartości elementu. Jednakże wartość wciąż może zostać zmodyfikowana poprzez skrypt.
tabindex
Typ: integer
Porządek dla przełączania elementów klawiszem Tab. Elementy o wyższym tabindex umieszczane są w dalszej części sekwencji przełączania.
type
Typ: jedna z wartości poniżej
Możemy ustawić typ atrybutu na jeden z poniższych określonych typów elementu datepicker, aby je zastosować:
  • normal: Element datepicker z trzema polami dla wprowadzenia roku, miesiąca i dnia. Ta wartość jest domyślna, więc nie określaj typu atrybutu, jeśli jego wartość jest już pobrana.
  • grid: Element datepicker, który wyświetla siatkę kalendarza , gdzie jeden miesiąc jest pokazany w jednym czasie.
  • popup: Element datepicker z trzema polami do wprowadzenia lecz but an additional dropdown button, which, when pressed, will display a popup calendar grid.

 

value
Typ: string
Łańcuch znaków pozwalający na łączenie sie wartości daty z elementem. Nie jest stosowany dla określonego celu, lecz możemy uzyskać do niego dostęp przy pomocy skryptu, wykorzystując go do własnych celów.

Własności

Metody

Dziedziczy z elementu XUL
blur, click, doCommand, focus, getElementsByAttribute

Dziedziczy z elementu DOM
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()

Podobne

Interfejsy
nsIDOMXULControlElement

Autorzy i etykiety dokumentu

Autorzy tej strony: teoli, lmorchard, Ptak82, Mgjbot
Ostatnia aktualizacja: teoli,