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.
Przykłady
<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 (
) dla elementu.label
Przykład
<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
natype
checkbox
lubradio
, aby zmiana atrybutuchecked
mogła odnosić jakiekolwiek skutki.
-
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.
<!-- 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"/>
-
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 oknaprefwindow
. Wartość opcji (z elementupreference
) zostanie zaktualizowana zgodnie z wartością własnościvalue
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
-
accessible
- Typ: nsIAccessible
- Zwraca obiekt dostępności dla elementu.
Metody
Podobne
- Interfejsy
- nsIAccessibleProvider, nsIDOMXULCheckboxElement