Pojedyncza pozycja do wybrania w elemencie menupopup
. Działa bardzo podobnie jak button
, lecz jest ona renderowana przez menu
.
Dodatkowe informacje są dostępne w kursie XUL.
- Atrybuty
- acceltext, accessible, accesskey, allowevents, autocheck, checked, command, crop, description, disabled, image, key, label, name, selected, tabindex, type, validate, value
- Klasy stylów
- menuitem-iconic, menuitem-non-iconic
Przykład
<menu id="edit-menu" label="Edycja"> <menupopup id="edit-popup"> <menuitem label="Wstecz"/> <menuitem label="Dalej"/> </menupopup> </menu>
Atrybuty
-
acceltext
- Typ: string
-
Text that appears beside beside the
menu
label to indicate the shortcut key (accelerator key) to use to invoke the command. If this value is set, it overrides an assigned key set in the key attribute. This attribute does not apply to menus directly on the menubar.
-
accessible
- Typ: nsIAccessible
- Zwraca obiekt dostępności dla elementu.
-
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
-
allowevents
- Typ: boolean
-
Jeśli
true
, zdarzenia przechodzą do dziecka elementu. Inaczej, zdarzenia są przypasowane do tego tylko elementu.
-
autoCheck
- Typ: boolean
- Gdy atrybut ten ma wartość
true
lub nie jest ustawiony, stan zaznaczenia przycisku będzie przełączany przy każdym jego naciśnięciu. Gdy wartość została ustawiona nafalse
, stan zaznaczenia musi być dopasowany ręcznie.
-
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; }
-
description
- Typ: string
- Tekst opisowy do wyświetlenia w dodatku do tytułu okienka dialogowego.
-
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.
-
selected
- Typ: boolean
- Sygnalizuje gdzie element jest zaznaczony lub nie. Ta wartość jest tylko do odczytu. Aby zmienić zaznaczenie, ustaw pozostałe własności
selectedIndex
lubselectedItem
stanowiące ten element.
-
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.
-
validate
- Typ: jedna z poniższych wartości
- Atrybut ten określa, czy obrazek ma być wczytywany z pamięci podręcznej. Może być to przydatne, jeśli obrazki są wczytywane z serwera zdalnego, albo planowana jest częsta ich podmiana. Poniższe wartości są akceptowane; pominięcie tego atrybutu spowoduje zastosowanie wartości domyślnej.
-
always
: Obrazek będzie zawsze sprawdzany, czy powinien być wczytany ponownie. -
never
: Obrazek będzie wczytywany z pamięci podręcznej, o ile to tylko możliwe.
-
value
- Typ: string
- Atrybut łańcucha znaków pozwalający na współpracę wartości danych z elementem. Nie jest stosowany dla określenia jakiegoś konkretnego celu, lecz można go wykorzystać w skrypcie do własnego użytku.
Własności
- {{ XULProp("control") }} {{ mediawiki['#switch']('<magic name="\"PAGENAME\"/">', XUL:menuitem, XUL:menuseparator = ) }}</magic>
{{ Fx_minversion_inline(3) }}
- Typ: id elementu
- Pobiera i ustawia wartość atrybutu {{ XULAttr("control") }}.
Dziedziczy z elementu XUL |
Metody
Klasy stylów
-
menuitem-iconic
- Zastosuj tą klasę, aby mieć wyświetlony obrazek na
menuitem
. Określa obrazek za pomocą arybutuimage
.
-
menuitem-non-iconic
- Normalnie,
menuitem
posiada margines z lewej strony na obrazek lub znak zaznaczenia. Ta klasa może zostać użyta do usunięcia tego marginesu, więc ta pozycja menu pojawi się z lewej strony brzegu menupopup.
Podobne
- Elementy
-
menu
,menubar
,menulist
,menupopup
,menuseparator