A command element can be used to invoke an operation that can come from multiple sources. For example, a clipboard paste operation can be invoked from the Edit menu, a context menu and by pressing a keyboard shortcut. You attach the code to the command using the oncommand attribute. It will be called no matter how it is invoked by the user. In addition, disabling the command will automatically disable the menu items and keyboard shortcuts.
Commands are identified by their idchrome://global/content/globalOverlay.js in your window, you can use the function goDoCommand function to invoke the command. Using this function has the advantage that the command will be sent to the part of the UI which will respond to it. Typically, this will be the currently focused element.
Like a broadcaster, commands forward attributes to other elements.
More information is available in the XUL tutorial. See also: command attribute, commandset element
The following code will send a paste command (cmd_paste) to the currently focused element:
// First include chrome://global/content/globalOverlay.js
goDoCommand("cmd_paste");
Example with two buttons
<commandset><command id="cmd_openhelp" oncommand="alert('Help');"/></commandset>
<button label="Help" command="cmd_openhelp"/>
<button label="More Help" command="cmd_openhelp"/>
disabledcommand event will not fire. In the case of form elements, it will not be submitted. Do not set the attribute to true, as this will suggest you can set it to false to enable the element again, which is not the case.
disabled attribute is allowed only for form controls. Using it with an anchor tag (an <a> link) will have no effect.disabled property which, except for menus and menuitems, is normally preferred to use of the attribute, as it may need to update additional state.oncommandreservedcommand
| Inherited Properties |