This is an archived page. It's not actively maintained.

menuitem

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
W艂asno艣ci
control, label, selected, 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

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 (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



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 na false, stan zaznaczenia musi by膰 dopasowany r臋cznie.


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; }



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.
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.
key
Typ: id element
Ustawia id elementu key, kt贸rego klawisz skr贸tu jest wy艣wietlony w menuitem.
label
Typ: string
Etykieta, kt贸ra zostanie wy艣wietlona na elemencie. Je艣li zostanie on usuni臋ty, to 偶aden tekst nie zostanie wy艣wietlony.
name
Typ: nazwa jako 艂a艅cuch znak贸w
Opcja menuitem z t膮 sam膮 nazw膮 umieszczona w jednej grupie. Tylko jedna pozycja menuitem w ka偶dej grupie opcji, mo偶e by膰 zaznaczona w tym samym czasie.

 

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 lub selectedItem 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.
type
Typ: jedna z warto艣ci poni偶ej
Mo偶e zosta膰 u偶yta do tworzenia pozycji wielokrotnego (pole wyboru) lub pojedynczego wyboru (przycisk opcji) menu.
  • checkbox: menuitem jest zaznaczony. Atrybut checked okre艣la gdzie pozycja menu jest wybrana, a gdzie nie.
  • radio: menuitem staje si臋 cz臋艣ci膮 grupy przycisk贸w opcji (radio). Inne pozycje menu, kt贸re maj膮 t膮 sam膮 warto艣膰 dla ich atrybutu name s膮 cz臋艣ci膮 tej samej grupy radio. Tylko jedna pozycja menu w tej samej grupie mo偶e by膰 zaznaczona.


Wi臋cej informacji na temat dodawania pozycji opcji menu znajduje si臋 w kursie XUL

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

control<magic name="\"PAGENAME\"/"></magic>

Typ: id elementu
Pobiera i ustawia warto艣膰 atrybutu control.
label
Typ: string
Pobiera i ustawia warto艣膰 atrybutu label.


selected
Typ: boolean
Pobiera i ustawia warto艣膰 atrybutu selected.
value
Typ: string
Pobiera i ustawia warto艣膰 atrybutu value.

Dziedziczy z elementu XUL
align, , allowEvents, , boxObject, builder, , , , className, , , , , collapsed, contextMenu, controllers, database, datasources, dir, , , flex, height, hidden, id, , , left, , maxHeight, maxWidth, menu, minHeight, minWidth, , , , , , , observes, ordinal, orient, , pack, , persist, , , , ref, resource, , , , , statusText, style, ,, tooltip, tooltipText, top, width

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()

Klasy styl贸w

menuitem-iconic
Zastosuj t膮 klas臋, aby mie膰 wy艣wietlony obrazek na menuitem. Okre艣la obrazek za pomoc膮 arybutu image.
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
Interfejsy
nsIAccessibleProvider, nsIDOMXULSelectControlItemElement