checkbox

Element, który można włączać i wyłączać. Zazwyczaj jest wyświetlany jako pusty prostokąt, kiedy jest wyłączony i jako prostokąt z zaznaczeniem, kiedy jest włączony. Użytkownik posiada możliwość włączenia stanu pola wyboru poprzez zaznaczenie pudełka myszą. Etykieta, określona atrybutem label może być dodana obok pola wyboru.

Dodatkowe informacje są dostępne w kursie XUL.

Atrybuty
accesskey, checked, command, crop, disabled, image, label, preference, tabindex
Własności
accessKey, accessible, checked, command, crop, disabled, image, label, tabIndex, value

Przykłady

Image:XUL_ref_checkbox.png
<checkbox label="Enable JavaScript" checked="true"/>
<checkbox label="Enable Java" checked="false"/>

Atrybuty

accesskey
Typ: znak
Powinien być ustawiony na literę, która zostanie zastosowana jako klawisz dostępu. Litera ta powinna być jedną z liter, które są wyświetlane w etykiecie tekstowej (label) dla elementu.


Przykład

grafika:XUL_ref_accesskey_attr.png
<vbox>	
  <label value="Enter Name" accesskey="e" control="myName"/>
  <textbox id="myName"/>
  <button label="Cancel" accesskey="n"/>
  <button label="Ok" accesskey="O"/>
</vbox>

Zobacz także

Atrybut label, atrybut acceltext



checked
Typ: boolean
Określa, czy przycisk jest zaznaczony. Konieczne jest ustawienie atrybutu type na checkbox lub radio, aby zmiana atrybutu checked mogła odnosić jakiekolwiek skutki.


command
Typ: id elementu
Ustawiony na wartość atrybutu id elementu command, obserwowanego przez ten element.
crop
Typ: jedna z poniższych wartości
Jeśli etykieta elementu jest zbyt duża by zmieścić się w danym miejscu, to jej tekst zostanie skrócony po stronie określonej przy pomocy atrybutu crop. Wycięty fragment tekstu zostanie zastąpiony wielokropkiem. Jeśli kierunek pudełka jest określony w lewą stronę, to skrócenie tekstu nastąpi w tym samym kierunku (czyli z lewej strony):
  • start: Tekst będzie skrócony z lewej strony.
  • end: Tekst będzie skrócony z prawej strony.
  • left: Tekst będzie skrócony z lewej strony.
  • right: Tekst będzie skrócony z prawej strony.
  • center: Tekst będzie skrócony w środku, pokazując oba końce: początek i koniec normalnego tekstu.
  • none: Tekst nie będzie skrócony przy zastosowaniu wielokropka. Jednakże, tekst skrócony zostanie po prostu obcięty, jeśli będzie za duży. Strona skrócenia owego tekstu zależy od rozmieszczenia tekstu określonego w arkuszu stylów CSS.
 menupopup > menuitem, menupopup > menu { max-width: none; }



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"/>
image
Typ: adres URL obrazka
Adres URL obrazka do wyświetlenia na elemencie. Jeśli ten atrybut zostanie opuszczony, to żaden obrazek nie zostanie wyświetlony. Pozycja obrazka jest określona przez atrybuty dir i orient.
label
Typ: string
Etykieta, która zostanie wyświetlona na elemencie. Jeśli zostanie on usunięty, to żaden tekst nie zostanie wyświetlony.
preference
Typ: id elementu
Łączy dany element z odpowiadającym mu elementem preference. Atrybut ten ma skutek tylko wewnątrz okna prefwindow. Wartość opcji (z elementu preference) zostanie zaktualizowana zgodnie z wartością własności value tego elementu.



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.

Własności

accessKey
Typ: znak
Pobiera i ustawia wartość atrybutu accesskey.
accessible
Typ: nsIAccessible
Zwraca obiekt dostępności dla elementu.
checked
Typ: boolean
Pobiera i ustawia wartość atrybutu checked.


command
Typ: element id
Pobiera i ustawia wartość atrybutu command.
crop
Typ: string
Pobiera i ustawia wartość atrybutu crop.
disabled
Typ: boolean
Pobiera i ustawia wartość atrybutu disabled.
image
Typ: adres URL obrazka
Pobiera i ustawia wartość atrybutu image.
label
Typ: string
Pobiera i ustawia wartość atrybutu label.


tabIndex
Typ: integer
Pobiera i ustawia wartość atrybutu tabindex.
value
Typ: string
Pobiera i ustawia wartość atrybutu value.

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
nsIAccessibleProvider, nsIDOMXULCheckboxElement

Autorzy i etykiety dokumentu

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