http://www.xulplanet.com/tutorials/xultu/lists.html http://www.xulplanet.com/reference/elemref/ref_menulist.html An element that can be used for drop-down choice lists. The user may select one of the elements displayed in the menulist. The currently selected choice is displayed on the menulist element. To create the drop-down, put a menupopup inside the menulist containing the choices as menuitem elements. nsIAccessibleProvider nsIDOMXULMenuListElement This should be set to a letter that is used as a shortcut key. This letter should be one of the characters that appears in the label text for the menulist. This letter will typically be drawn underlined, although this behavior will be platform and theme specific. When the user presses ALT (or a similar key that varies on each platform) and the access key, the menulist will be activated from anywhere in the window. Although the value is case insensitive, a letter with the case matching the accesskey attribute will used if both cases exist in the label. If the label of the menulist is too small to fit in its given space, the text will be cropped on the side specified by the crop attribute. An ellipsis will be used in place of the cropped text. If the box direction is reversed, the cropping is reversed. The text will be cropped on its left side. The text will be cropped on its right side. (Deprecated) The text will be cropped on its left side. (Deprecated) The text will be cropped on its right side. The text will be cropped on both sides. The text will be not be cropped using an ellipsis. However, the text will simply be cut off if it is too large. The side depends on the CSS text alignment. If this attribute is true or omitted, the selected item on the menu will update to match what the user entered in the textbox. If the text does not match any of the items in the list, the menu selection is cleared. If this attribute is false, the selection is never updated to match the text box. This attribute applies only to editable menulists. Indicates whether the menulist is disabled or not. If this attribute is set to true, the menulist is disabled. This is usually drawn with the text in grey. If the menulist is disabled, it does not respond to user actions. The element cannot be focused and the command event will not fire. The element will still respond to mouse events. To enable the menulist, leave the attribute out entirely as opposed to setting the value to false. Indicates that the value of the menulist can be modified by typing directly into the value field. This is rendered as a textbox with a drop-down arrow beside it. The user may enter text into the textbox or select one of the choices by clicking from the drop-down. This attribute is set to true if the menulist element is focused. The URL of the image to appear on the menulist. If this is attribute is left out, no image appears. The position of the image is determined by the dir and orient attributes. The label that will appear on the menulist. If this is left out, no text appears. If true, the menu popup is showing. You can change this value to show or hide the popup. Connects the menulist to a corresponding preference. This attribute only has any effect when used inside a prefwindow. The value of the preference will be updated to match the value property of the menulist. If set to true, then the user cannot type into the field of an editable menulist. However, the value may still be modified by a script. Indicates how the menu width and the popup width are determined. If the sizetopopup attribute is left out or set to none, the menu will be its preferred width and the popup may extend outside of this width, unaffected by the maximum width of the menu itself. The width of the popup will not be constrained to the size of the menulist. If set to always, the menu's width will be the same as that necessary for the menupopup. If the menu has a maximum width, the popup will also be this width. The URL of the image to appear on the menulist. If this attribute is left out, no image appears. The tab order of the element. The tab order is the order in which the focus is moved when the user presses the Tab key. Elements with a higher tabindex are later in the tab order sequence. The value of the value property of the currently selected item in the menulist. You can select an item with a particular value by setting this property. Returns the accessibility object for the menulist. appendItem ( label , value , description ) Creates a new menuitem element and adds it to the end of the menulist. You may optionally set a value and description. The function returns the new item. Set to the description of the currently selected menuitem. A reference to the textbox element used for editable menu lists. This property is read only and applies to editable menulists only. insertItemAt ( index , label , value , description ) Creates a new menuitem element and inserts it at a specific position in the menu. You may optionally set a value and description. The function returns the new item. A reference to the nsIMenuBoxObject which implements the menu. A reference to the menupopup used by the menulist. This property is read-only. removeAllItems ( ) Removes all of the items in the menu. removeItemAt ( index ) Removes the child item in the menu at the given index. The function returns the removed item. select ( ) Select all the text in the menulist's textbox. This property applies to editable menulists only. Holds the index of the currently selected item in the menu. If no item is currently selected, this will be set to -1. You can select an item by setting this value. Holds the element of the menu that is currently selected. If no element is currently selected, this will be null. Use selectedIndex to retrieve the position of the selected item in the menu. Get and sets the value of the tabindex attribute.