XUL:command

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

« Dokumentacja XUL [ Przykłady | Atrybuty | Własności | Metody | Podobne ]

Element command może być stosowany do przywołania operacji, która może być wywoływana z różnych miejsc. Na przykład, operacja wklejenia ze schowka może być wywołana z menu Edycja, menu kontekstowego i poprzez skrót klawiaturowy. Można dołączyć kod do elementu command poprzez atrybut oncommand. Zostanie on wywołany bez względu na to, jak został przywołany przez użytkownika. Ponadto, wyłączanie elementu command spowoduje automatyczne wyłączenie elementów menu i skrótów klawiaturowych.

Polecenia są identyfikowane poprzez ich atrybut id. Po dołączeniu skryptu chrome://global/content/globalOverlay.js do okna można stosować funkcję goDoCommand aby wywołać dane polecenie. Stosowanie tej funkcji ma tę zaletę, że polecenie zostanie wysłane do części interfejsu użytkownika, która na nie odpowiada. Zwykle będzie to element z fokusem w danym momencie.

Podobnie jak element broadcaster, elementy command przekazują atrybuty do innych elementów. Dodatkowe informacje są dostępne w kursie XUL. Zobacz także: atrybut command, element commandset

Atrybuty: disabled, label, oncommand

[edytuj] Przykłady

Następujący kod wyśle komendę paste (cmd_paste) do aktualnie aktywnego elementu:

 goDoCommand("cmd_paste");

Przykład z dwoma przyciskami:

<command id="cmd_openhelp" oncommand="alert('Help');"/>
<button label="Help" command="cmd_openhelp"/>
<button label="More Help" command="cmd_openhelp"/>

[edytuj] Atrybuty

Dziedziczy z elementu XUL
align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

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.

label: Typ: string; Etykieta, która zostanie wyświetlona na elemencie. Jeśli zostanie on usunięty, to żaden tekst nie zostanie wyświetlony.

oncommand: Typ: kod skrypt; Ta funkcja obsługi zdarzenia jest wywołana w momencie aktywacji polecenia. Ma to miejsce, gdy użytkownik zaznaczy pozycję menu lub kiedy naciśnie skrót klawiaturowy przypisany do polecenia.