A unique identifier so that you can identify the element with. You can use this as a parameter to getElementById() and other DOM functions and to reference the element in style sheets.
Set to true if the element is to act as a container which can have child elements. This would be used for folders. This will be set by the template builder as needed.
For elements placed directly within a stack, specifies the pixel position of the left edge of the element relative to the left edge of the stack.
When an element is in an overlay, the position is an index where the child is inserted. The position is one-based, so use a value of 1 to place the element at the beginning. This attribute is ignored if either an insertbefore or insertafter attribute matches an element.
For elements placed directly within a stack, specifies the pixel position of the top edge of the element relative to the top edge of the stack.
For template-generated content, the attribute should be placed on the element where content generation should begin. Thus, it should be placed on an element that is a descendant of a template. The value should be set to rdf:*.
Elements that appear inside the element with the attribute will be repeated for each node in the RDF datasource. Elements outside will appear only once.
Set to true if the element is a container that contains no children. This will be set by the template builder as needed.
For template-generated elements, this attribute is used to specify the root RDF node where content generation begins. This will correspond to the value of an about attribute on an RDF container. This attribute should be placed alongside the datasources attribute.
The preferred width of the element. The value should not include a unit as all values are in pixels. The actual displayed width may be different if the element or its contents have a minimum or maximum width, or the size is adjusted by the flexibility or alignment of its parent. The CSS width property may also be used.
This event handler is called when the command is activated. This occurs when a user selects a menu item or presses a keyboard shortcut attached to the command.
An event handler for the load event of a window.
The unload event is raised when the document is unloaded.
The code in the onchange attribute is called when the value of the element is changed.
An event handler for the select event on the control.
The onblur property returns the onBlur event handler code, if any, that exists on the current element.
The onfocus property returns the onFocus event handler code on the current element.
If true, events are passed to children of the element. Otherwise, events are passed to the element only.
Valid on any element that has a datasources attribute. When multiple datasources are used, one may override an assertion from another. This attribute, if true, which is the default, allows a datasource to negate an earlier assertion.
Valid on any element that has a datasources attribute. When multiple datasources are used, one may override an assertion from another. This attribute, if true, which is the default, allows a datasource to negate an earlier assertion.
If true, then the element is collapsed and does not appear. It is equivalent to setting the CSS visibility property to collapse.
Alternate name for the context attribute, but also has a corresponding script property contextMenu.
Indicates the flexibility of the element, which indicates how an element's container distributes remaining empty space among its children. Flexible elements grow and shrink to fit their given space. Elements with larger flex values will be made larger than elements with lower flex values, at the ratio determined by the two elements. The actual value is not relevant unless there are other flexible elements within the same container. Once the default sizes of elements in a box are calculated, the remaining space in the box is divided among the flexible elements, according to their flex ratios. Specifying a flex value of 0 has the same effect as leaving the flex attribute out entirely.
The preferred height of the element in pixels. The actual displayed height may be different if the element or its contents have a minimum or maximum height. The CSS height property may also be used.
If set to true, the element is not displayed. This is similar to setting the CSS display property to 'none'.
When an element is in an overlay, the insertafter attribute specifies the id of the element in the base window that the element should appear after. This attribute overrides the insertbefore attribute. This value may be a comma-separated list of ids, which are scanned and the first one found in the window is used.
When an element is in an overlay, the insertbefore attribute specifies the id of the element in the base window that the element should appear before. This value may be a comma-separated list of ids, which are scanned and the first one found in the window is used.
The maximum height of the element. This corresponds to the max-height CSS property.
The maximum width of the element. This corresponds to the max-width CSS property.
Alternate name for the popup attribute, but also has a corresponding script property 'menu'.
The minimum height of the element. This corresponds to the min-height CSS property.
The minimum width of the element. This corresponds to the min-width CSS property.
Set to an id of a broadcaster element that is being observed by the element. If an attribute changes in the broadcaster it is also changed in the observer.
An integer which specifies the position of the element within its parent. By default, elements appear in the order they appear in the XUL code. The ordinal attribute can be used to change the order. Note the default ordinal for elements is 1. You can retrieve the displayed order by using the properties of the boxObject of the container.
Should be set to the value of the id of the popup element that should appear when the user clicks on the element.
Mozilla 1.8
If true, the element may be used as one that modifies a preference in a prefwindow. The preference attribute may be used to connect to a preference element. This is useful for custom elements implemented in XBL. The element should fire change or select events when the value is changed so that the preference will update accordingly.
When placed on an element in an overlay, it indicates that the element in the base file should be removed from the window.
For template-generated content, this specifies the sort key, if you would like the content to be sorted. The key should be the full URI of the resource to sort by, for example 'http://home.netscape.com/NC-rdf#Name'. Place this attribute on the same element as the datasources attribute. Use sortResource2 to specify a secondary sort key.
A secondary key for sorted content.
Used to set the text that appears on the status bar when the user moves the mouse over the element. Mozilla doesn't adjust the status bar automatically however. This attribute serves only as a place to keep the text. In Firefox, this text is automatically placed in the statusbar for menuitems on the menu bar.
CSS style rules to be applied to the element. Syntax is as in the HTML style attribute. It is preferred to put style rules in style sheets.
For template generated elements, this attribute may optionally be placed on the root node (the element with the datasources attribute) to refer to a template that exists elsewhere in the XUL code. This template attribute should be set to the id of the template element. This might be used to share a single template between multiple trees or menus. If this attribute is not specified, there should be a template element directly inside the node.
Used to set the text which appears in the tooltip when the user moves the mouse over the element. This can be used instead of setting the tooltip to a popup for the common case where it contains only text. The tooltip is displayed in a default tooltip which displays only a label, however the default tooltip may be changed by setting the default attribute on a tooltip element.
Set this attribute to true to have the cursor switch to a waiting cursor while the mouse is hovering over the element. Usually, you would only use this on the window element or other top-level elements.
New in Firefox 3
Specify background color of the window's titlebar when it is active (foreground). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
Set this attribute to true to have the chrome including the titlebar hidden.
New in Firefox 3
Specify background color of the window's titlebar when it is inactive (background). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
The horizontal position at which the window appears on the screen.
The vertical position at which the window appears on the screen.
The text to appear in the title bar of the window.
Set to a string which can be used to identify the type of window. This might be used, for example, to distinguish between a browser window and an editor window. Some of Mozilla's window handling functions use this attribute to group windows of the same type together.
New in Firefox 3
Specify background color of the window's titlebar when it is active (foreground). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
The access key to use for the "accept" button.
The access key to use for the "cancel" button.
The access key to use for the "disclosure" button.
The access key to use for the first extra button.
The access key to use for the second extra button.
The access key to use for the "help" button.
The value of the align attribute for the box containing the buttons.
The value of the dir attribute for the box containing the buttons.
If true, the accept button is disabled.
The label to appear on the "accept" button.
The label to appear on the "cancel" button.
The label to appear on the "disclosure" button.
The label to appear on the first extra button.
The label to appear on the second extra button.
The label to appear on the "help" button.
The value of the orient attribute for the box containing the buttons.
The value of the pack attribute for the box containing the buttons.
A comma-separated list of buttons to appear in the dialog box. The buttons will be placed in suitable locations for the user's platform and basic event handling will be performed automatically. The following values can be used in the list:
* accept: The OK button, which will accept the changes when pressed. This button will also be the default button.
* cancel: The cancel button which will cancel the operation.
* help: A help button for displaying help about the dialog.
* disclosure: A button to show more information. This might be a button or a disclosure triangle.
* extra1: An optional additional button. You can set its label with the buttonlabelextra1 attribute.
* extra2: A second optional additional button. You can set its label with the buttonlabelextra2 attribute.
Normally this attribute should not be set, but if it is, it specifies the default button in the dialog. Typically, this means that the button will be activated when the Enter key is pressed. This should be set to one of the same values as those for the buttons attribute.
New in Firefox 3
Specify background color of the window's titlebar when it is inactive (background). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
The code in this attribute is called when the accept button is pressed, or when the acceptDialog method is called. If the handler returns true, the dialog will indeed go away, but if it returns false it will not.
The code in this attribute is called when the "cancel" button is pressed or when the cancelDialog method is called. If the routine returns true, the dialog will indeed go away, but if it returns false it will not.
The code in this attribute is called when the "disclosure" button is pressed.
The code in this attribute is called when the first extra button is pressed.
The code in this attribute is called when the second extra button is pressed.
The code in this attribute is called when the "help" button is pressed.
The text to appear in the title bar of the window.
Not Supported in Firefox!
When set to true, the grippy will be hidden. When set to false, the default, the grippy will be shown.
If you set this attribute to the id of a statusbar element, the label on the statusbar will update to the statustext of the items on the menu as the user moves the mouse over them.
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.
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 element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The label that will appear on the element. If this is left out, no text appears.
This attribute is set on an item in a menu when it is being hovered over. Typcially, the theme will use this to highlight the item. A DOMMenuItemActive event will be sent to the item when the item is hovered over, and a DOMMenuItemInactive event will be sent to the item when the selection moves away.
For the menu type buttons, the open attribute is set to true when the menu is open. The open attribute is not present if the menu is closed.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
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 element.
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 element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
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 true if the element is focused.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
For the menu type buttons, the open attribute is set to true when the menu is open. The open attribute is not present if the menu is closed.
Connects the element 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 element.
If set to true, then the user cannot change the value of the element. However, the value may still be modified by a script.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Overrides the horizontal position of the popup specified by the showPopup method.
Overrides the vertical position of the popup specified by the showPopup method.
If true, keyboard navigation between items in the popup is disabled.
This event is sent to a popup after it has been hidden.
This event is sent to a popup when it is about to be hidden.
This event is sent to a popup just before it is opened. This handler is usually used to dynamically set the contents when the user requests to display it. Returning false from this event handler prevents the popup from appearing.
This event is sent to a popup after it has been opened, much like the onload event is sent to a window when it is opened.
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.
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 element.
If this attribute is true, or left out, the menuitem check mark will update each time the menu item is selected. If this attribute is false, the check mark must be adjusted manually.
Indicates whether the element is checked or not.
Use hasAttribute() to determine whether this attribute is set instead of getAttribute().
Set to the id of a command element that is being observed by the element.
Descriptive text to appear in addition to the dialog title.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The URL of the image to appear on the element. If this attribute is empty or left out, no image appears. The position of the image is determined by the dir and orient attributes.
Set to the id of a key element whose key shortcut is displayed in the menuitem.
The label that will appear on the element. If this is left out, no text appears.
Radio menuitems with the same name as put into a group. Only one menuitem in each radio group can be checked at a time.
Indicates whether the element is selected or not. This value is read-only. To change the selection, set either the selectedIndex or selectedItem property of the containing element.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
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.
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 element.
Set to the id of a command element that is being observed by the element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
Indicates whether the element is selected or not. This value is read-only. To change the selection, set either the selectedIndex or selectedItem property of the containing element.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Gets and sets the index of the currently selected panel. The first item is at index 0.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
Used to specify whether the separator is a horizontal or vertical separator. Note that the values are the reverse of what seems more likely.
May optionally be set to the variable to use as the container or reference variable. If not specified, the variable specified in the uri
attribute of the content tag in the template's first rule is used.
May optionally be set to the variable to use as the member variable. If not specified, the variable specified in the uri
attribute in the action body of the template's first rule is used.
Indicates whether rules match based on containment. If not specified, the rule may match regardless of whether a node is a container or not.
Indicates whether rules match based on emptyness. If not specified, the rule may match regardless of whether a node has children or not.
If set, the rule will only match the corresponding tag. This may be used to have separate rules for leaf and container nodes with different tags.
If this attribute is set to Integer, the rule will only match RDF nodes with a parse type of Integer.
Set to true to indicate that the case does not matter when making comparisons. Otherwise, the default value is false, to indicate that the value should match with the same case.
Set to true to indicate that the value
contains multiple values separated by commas. Any of the values may match. Otherwise, the entire value string is compared.
Set to true to indicate that the comparison should be reversed. The where
clause matches if the condition is false, and does not match if the condition is true.
The variable or string to compare.
The value to compare.
The object of the element. It can be a variable reference, an RDF resource URI, or an RDF literal value.
The predicate or property to match. This must be a URI of the property.
The subject of the element. It can be a variable reference or an RDF resource URI.
For XML queries, an XPath expression which returns results. Any namespace prefixes declared on the element may be used within the expression.
Used to specify the variable name for the content. When a rule is evaluated, it scans through each resource in the RDF datasource looking for a match. Each resource is placed in the variable specified in the uri attribute in turn. Then, the other rules are evaluated for a match. This attribute should always be present.
This may be set to a tag name. If set, the conditions will only match if the template builder is parsing content for an element directly inside this tag. For example, by using a value of treechildren, the condition will only match when placing elements directly inside a treechildren tag. Thus, nested elements will not match because they are directly inside a treeitem . This attribute is useful to provide different rules for outer and inner elements.
A variable reference to a node that is expected to be a container. If the variable is the same as the uri attribute on the content element, the resource must be a container element in order to match.
A variable reference to a node that is expected to be a child of the element that is referred to by the container element.
For XML queries, an XPath expression which returns results. Any namespace prefixes declared on the element may be used within the expression.
Variable URI to assign to.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
New in Firefox 3.
true initially enables smooth scrolling for the corresponding arrowscrollbox, false disables it. Currently, smooth scrolling supports horizontal arrowscrollboxes only.
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 sequence.
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 element.
If this attribute is true or left out, the checked state of the button will be switched each time the button is pressed. If this attribute is false, the checked state must be adjusted manually. When autoCheck is true, the button type should be "checkbox" or "radio".
Indicates whether the element is checked or not.
Use hasAttribute() to determine whether this attribute is set instead of getAttribute().
This attribute may be used to create three state buttons, numbered 0, 1 and 2. When in state 0 or 1, pressing the button will switch to the opposite state. When in state 2, pressing the button will switch to state 0. This means that the button acts like a checkbox except that there is a third state which must be set manually by adjusting the check state. If you wish to have different behavior for how the states are adjusted, set the autoCheck attribute to false and adjust the state with a script. The type attribute must be set to checkbox for buttons with a check state. Constants for the possible values for this attribute are in the nsIDOMXULButtonElement interface.
Set to the id of a command
element that is being observed by the element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The URL of the image to appear on the element. If this attribute is empty or left out, no image appears. The position of the image is determined by the dir and orient attributes.
Buttons with type="radio" and the same value for their group attribute are put into the same group. Only one button from each group can be checked at a time. If the user selects one the buttons, the others in the group are unchecked.
Mozilla 1.8
This attribute should be used to set the usage for common buttons. Some platforms display these buttons with a small icon indicating their usage. This should be used in place of the image attribute. Possible values include: accept, cancel, help, open, save, find, clear, yes, no, apply, close, print, add, remove, refresh, go-forward, go-back, properties, select-font, select-color, network. If you are using a button that matches one of these common usages, use the icon attribute to indicate this.
The label that will appear on the element. If this is left out, no text appears.
For the menu type buttons, the open attribute is set to true when the menu is open. The open attribute is not present if the menu is closed.
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 sequence.
Set to true to enable autocomplete of fields.
Set to false to disable autoscroll for this browser. If this attribute is set to true or omitted, autoscroll will be enabled or depending on the user preference general.autoScroll.
If false, an arrow button will appear on the end of the textbox which will open a dropdown menu of all available results. The default value is true, hiding the dropdown button.
Set this attribute to true to disable the security UI for this browser. Omit this attribute off to enable it.
Whether or not to cause a typing caret to be visible in the content area. Default is false.
This attribute allows you to set a homepage for the browser element. It does not have any correlation with the user's browser homepage; instead it is a convenient property to hold a home page. You can switch to this home page using the goHome method.
The URL of the content to appear in the element.
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 element.
Indicates whether the element is checked or not.
Use hasAttribute() to determine whether this attribute is set instead of getAttribute().
Set to the id of a command
element that is being observed by the element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
Set this to the URL of an image to appear in the checkbox. If this attribute is left out, no image appears. You can have both an image and a label.
The label that will appear on the element. If this is left out, no text appears.
Connects the element 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 element.
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 sequence.
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 element.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text 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 sequence.
A value indicating the type of accessibility object for the element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The currently selected color. This is modified when the user selects a color. You can assign a string of the form #RRGGBB to this property to change the selected color.
The code in the onchange attribute is called when the value of the element is changed.
Connects the element 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 element.
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 sequence.
If this attribute is not present, the colorpicker is displayed inside the window. If this is set to the text button, the colorpicker is displayed as a button. When the user clicks the button, a popup appears for the user to select a color.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The label that will appear on the element. If this is left out, no text appears.
If true, the commandset is used for updating commands. Typically, this is used to update menu commands such as Undo and Cut based on when an event occurs. For example, since the Cut command is only valid when something is selected, a command updater might be used when the select event occurs.
A comma-separated list of event names that the command updater will update upon. If this attribute is not specified, or you set it to the value '*', all events are valid. Valid events are listed below, or you can use your own events. You can send a custom event by calling the UpdateCommands method of the command dispatcher.
* focus: Occurs when the focused element changes.
* select: Occurs when the selected text changed.
* clipboard: Occurs when the clipboard is changed.
* undo: Occurs when the undo buffer is changed.
This event occurs when a command update occurs. You would use this to update the disabled status of items.
A comma-separated list of element ids that the command updater will update upon. If this attribute is not specified, or you set it to the value '*', all elements are valid. The command update will only occur when the event occurs to one of the specified elements.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
which day of the week to display as the first day in the grid. The values range from 0 to 6, where 0 is Sunday and 6 is Saturday. The default value is determined by the locale, so only use this attribute if you want to override it.
If set to true, then the user cannot change the value of the element. However, the value may still be modified by a script.
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 sequence.
The initial value of the datepicker in the form YYYY-MM-DD.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Descriptive text to appear in addition to the dialog title.
The text to appear in the title bar of the window.
The URL of the content to appear in the element.
If set to the string content-primary, this editor becomes the primary content for the page. The window for the primary content can be retrieved more conveniently using window.content.
Whether or not to cause a typing caret to be visible in the content area. Default is false.
The URL of the content to appear in the element.
This event is sent to an image
element when an error occurs loading the image.
This event handler will be called on the image
element when the image has finished loading. This applies whether the image is applied via the src attribute or the list-style-image style property. If you change the image, the event will fire again when the new image loads. This event will not bubble up the element tree.
The URL of the content to appear in the element.
Set to the id of a command
element that is being observed by the element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The character that must be pressed. This should be set to a displayable character.
A label for the keyboard shortcut. This text would appear next to a menuitem
label if that menuitem
is associated with the key
element via its key attribute.
The event phase where the handler is invoked. This should be set to the value capturing to indicate during the event capturing phase or target to indicate at the target element or left out entirely for the bubbling phase.
For keys that do not have displayable characters, such as the Enter key or function keys, use this attribute instead of the key attribute.
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 element.
This attribute specifies the id of the element with which the label is associated. When the user clicks on the label, the associated element is given focus.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
Defines a URL to open when this element is clicked. Requires the class attribute to include text-link.
The text to be used for the label.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
If this attribute is not used, the user can navigate to specific items within the element by pressing keys corresponding to letters in the item's label. This is done incrementally, so typing more letters with select more specific items. This feature may be disabled by setting this attribute to true.
Connects the element 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 element.
The number of rows to display in the element. If the element contains more than this number of rows, a scrollbar will appear which the user can use to scroll to the other rows. To get the actual number of rows in the element, use the getRowCount
method.
If this attribute is not specified, a select event is fired whenever an item is selected, either by the user or by calling one of the select methods. If set to true, the select event is never fired.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
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 element.
Indicates whether the element is checked or not.
Use hasAttribute() to determine whether this attribute is set instead of getAttribute().
Set to the id of a command
element that is being observed by the element.
This attribute will be set to true if the listitem is the current item. This is typically used by a theme to customize the focus ring. To change the currently selected item in a listbox
, use the listbox property selectedItem
.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
Connects the element 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 element.
Indicates whether the element is selected or not. This value is read-only. To change the selection, set either the selectedIndex
or selectedItem
property of the containing element.
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 sequence.
You can make an item in a listbox
a checkbox by setting this attribute to the value checkbox.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
You can make a cell in a listbox
a checkbox by setting this attribute's value to checkbox.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
The persistence may be set to a non-zero value so that the notificationbox
's removeTransientNotifications
method does not remove them. This may be used to close a set of notifications as a group without affecting other notifications.
Numeric value that specifies the order in which the notifications appear. Should be one of the constants described in the notificationbox
's appendNotification
method.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Type: attribute name
The attribute that the observer is observing. When the value of the attribute changes, the broadcast event is called on the observer. Use the value * to observe all attribute of the broadcasters. The id , ref , and persist attributes are not observed.
The id of the broadcaster element that the observer is observing.
If false, the default value, the Escape key may be used to close the panel. If true, the Escape key cannot be used to close the panel.
Overrides the horizontal position of the popup specified by the showPopup
method.
If false, the default value, the currently focused element will be unfocused whenever the popup is opened or closed. If true, the focus is not adjusted.
If false, the default value, the panel will be hidden when the user clicks outside the panel or switches focus to another application. If true, the panel will only be closed when the hidePopup method is called.
This event is sent to a popup after it has been hidden.
This event is sent to a popup when it is about to be hidden.
This event is sent to a popup just before it is opened. This handler is usually used to dynamically set the contents when the user requests to display it. Returning false from this event handler prevents the popup from appearing.
This event is sent to a popup after it has been opened, much like the onload event is sent to a window when it is opened.
Overrides the vertical position of the popup specified by the showPopup
method.
The index within the SQL statement of the parameter.
The name of a parameter within the SQL statement. This name should appear within the query preceded by a colon.
An integer ranging from 0 to 100 that indicates the progress. For instance, setting the value to "0" shows an empty bar, "100" shows a bar at full length and "25" shows the first quarter of the bar. Characters after the number are ignored.
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 element.
Set to the id of a command
element that is being observed by the element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
This attribute is true if the element is focused.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
Type: string group name
Buttons with type="radio" and the same value for their group attribute are put into the same group. Only one button from each group can be checked at a time. If the user selects one the buttons, the others in the group are unchecked.
Indicates whether the element is selected or not. This value is read-only. To change the selection, set either the selectedIndex
or selectedItem
property of the containing element.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
This attribute is true if the element is focused.
Connects the element 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 element.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
If this attribute is not used, the user can navigate to specific items within the element by pressing keys corresponding to letters in the item's label. This is done incrementally, so typing more letters with select more specific items. This feature may be disabled by setting this attribute to true.
Connects the element 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 element.
The number of rows to display in the element. If the element contains more than this number of rows, a scrollbar will appear which the user can use to scroll to the other rows. To get the actual number of rows in the element, use the getRowCount
method.
If this attribute is not specified, a select event is fired whenever an item is selected, either by the user or by calling one of the select methods. If set to true, the select event is never fired.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
New in Firefox 3!
Text used for 'find-as-you-type' (FAYT) searching. In situations where the search text is ambiguous or missing, searchlabel can be used to give context to FAYT. If searchlabel is not present, FAYT falls back to use the label property.
Indicates whether the element is selected or not. This value is read-only. To change the selection, set either the selectedIndex
or selectedItem
property of the containing element.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
If true, the preference will be changed as soon as the user interface is modified.
For boolean preferences, if this attribute is set to true, it indicates that the value of the preference is the reverse of the user interface element attached to it. For instance, checking the checkbox disables the preference instead of enabling it.
The name of the preference to change. For example, the browser's home page is set with the preference browser.startup.homepage.
The code in the onchange attribute is called when the value of the element is changed.
If set to true, then the user cannot change the value of the element. However, the value may still be modified by a script.
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 sequence.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
Code defined here is called when the pane has been loaded, much like the load event for a window.
This attribute will be set to true for the currently selected prefpane
. To change the selected pane, use the prefwindow
's showPane
method.
The URI of the help page associated with a preference panel. The URI will be opened using the help viewer when the help button is pressed.
Type: overlay URL
The URL of the contents of preference pane. If this is not specified, the contents of the prefpane element is used.
New in Firefox 3.
Specify background color of the window's titlebar when it is active (foreground). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
The value of the align attribute for the box containing the buttons.
The value of the dir attribute for the box containing the buttons.
The value of the orient attribute for the box containing the buttons.
The value of the pack attribute for the box containing the buttons.
A comma-separated list of buttons to appear in the dialog box. The buttons will be placed in suitable locations for the user's platform and basic event handling will be performed automatically. The following values can be used in the list:
Normally this attribute should not be set, but if it is, it specifies the default button in the dialog. Typically, this means that the button will be activated when the Enter key is pressed. This should be set to one of the same values as those for the buttons attribute.
New in Firefox 3!
Specify background color of the window's titlebar when it is inactive (background). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
Set this to the id of the last selected pane. It will be opened by default the next time the preferences dialog is opened.
The code in this attribute is called when the OK button is pressed or the acceptDialog
method is called.
The code in this attribute is called when the accept button is pressed, or when the acceptDialog
method is called. If the handler returns true, the dialog will indeed go away, but if it returns false it will not.
The code in this attribute is called when the"cancel" button is pressed or when the cancelDialog
method is called. If the routine returns true, the dialog will indeed go away, but if it returns false it will not.
The code in this attribute is called when the"disclosure" button is pressed.
The code in this attribute is called when the"help" button is pressed.
Code defined here is called when the pane has been loaded, much like the load event for a window.
The text to appear in the title bar of the window.
Set this attribute to child for preference dialogs that are child dialogs of a main preferences window. This ensures that the preferences are only saved when the main dialog is closed, if this is the appropriate behaviour for the platform.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
The amount by which the attribute changes by when the arrows are clicked. The default value is 1.
The minimum value that may be set to. The default value is 0.
The maximum value that may be set to. The default value is expected.
The amount by which the value of attribute changes by when The default value is 10.
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 sequence.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
The URL of the script.
The language of the script. Usually, you would set this to application/x-javascript.
The current position of the scrollbar, which ranges from 0 to the value of the maxpos attribute. The default value is 0.
The amount by which the attribute changes by when the arrows are clicked. The default value is 1.
The maximum position of the scrollbar. The default value is 100.
The amount by which the value of the attribute changes by when ... . The default value is 10.
The URL of the property file that contains the localized strings.
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 element.
This is set to true if the tab is immediately after the currently selected tab. This is set automatically set when needed and you shouldn't adjust it manually. This is primarily useful for themes so that they can adjust the appearance of the area around the selected tab.
This is set to true if the tab is immediately before the currently selected tab. This is set automatically set when needed and you shouldn't adjust it manually. This is primarily useful for themes so that they can adjust the appearance of the area around the selected tab.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
This attribute will be set to true for the first tab. This attribute should not be set manually, but is useful in a theme if the first tab should be styled differently.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
This attribute will be set to true for the last tab. This attribute should not be set manually, but is useful in a theme if the last tab should be styled differently.
The id of the linked tabpanel element that will be displayed when the tab is selected. If this attribute is not used, the tab will be connected to the panel at the corresponding index in the tabpanels element that the tab is in its tabs container. However, if this attribute is used, this behavior is overridden, and the tab will always be linked to a specific panel. This might be used to avoid duplication by linking several tabs to one panel with slight differences to the content adjusted in the select event.
This attribute is set to true if the tab is selected by default.
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 sequence.
Gets and sets the index of the currently selected panel. The first item is at index 0.
If this attribute is set to true, the tabs
row will have a"new tab" button and"close" button on the ends. This feature is used by the tabbrowser
to provide the facilities for adding and closing tabs. You can set an image to the"new tab" and"close" buttons by applying them to the tabs-newbutton
and tabs-closebutton
classes respectively.
If this attribute is true the close button will be disabled.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
This script will be called when the close tab button is clicked.
This event is sent to the tabs
element when this tab is changed.
If true or omitted, the focus will be given to the first element in the corresponding tabpanel
when the tabs are navigated via the keyboard. If this attribute is false, the focus does not change during navigation.
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 sequence.
Not in Firefox!
Used to set the text which appears in the tooltip when the user moves the mouse over the new button in the tab row.
Not in Firefox!
This script will be called when the new tab button is clicked.
If set to true or omitted, the Control and Page Up or Page Down keys can be used to switch to the next or previous tab. If this attribute is set to false, these keys do not navigate between tabs.
If set to true or omitted, the tabbox
will switch to the next tab when the Control and Tab keys are pressed. If the Shift key is also held down, the previous tab will be displayed. If this attribute is set to false, these keys do not navigate between tabs.
Set to true to enable autocomplete of fields.
The id of a popup element used to hold autocomplete results for the element.
Set to false to disable autoscroll for this browser. If this attribute is set to true or omitted, autoscroll will be enabled or depending on the user preference general.autoScroll.
A reference to the context menu for the content area in the tabbrowser .
A reference to the tooltip element to be used for the content area in the tabbrowser .
If set to true or omitted, the Control and Page Up or Page Down keys can be used to switch to the next or previous tab. If this attribute is set to false, these keys do not navigate between tabs.
Not in Firefox!
This code executes when the user chooses the "Bookmark this Group of Tabs" command.
Not in Firefox!
This script will be called when the new tab button is clicked.
The text value to display. This value should be an RDF property.
New in Firefox 3!
Presence of this attribute indicates that the emptyText is now being displayed. Can be used for styling purposes.
For multiline textboxes, the number of columns to display.
New in Firefox 3!
The number of decimal places to display. The default is 0, which doesn't show any decimal places. The value Infinity may be used if you want no limit on the number of decimal places. Note that decimal numbers are stored as floats.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
New in Firefox 3!
A string that appears in the textbox when it has no value.
If true, the number box does not have arrow buttons next to it to allow the user to adjust the value. The value may still be adjusted with the keyboard. The default value is false.
The amount by which the attribute changes by when the arrows are clicked. The default value is 1.
New in Firefox 3!
If present and not empty, this will be exposed to screen readers through the label property.
The maximum value that the may be set to. The default value is .
The maximum number of characters that the textbox allows to be entered.
The minimum value that the may be set to. The default value is 0.
If true, the textbox displays multiple lines. If the user presses Enter, a new line is started. If false, the textbox only allows entry of one line.
New in Firefox 3!
How the text box handles pastes with newlines in them.
This event is sent when the value of the textbox is changed. The event is not sent until the focus is moved to another element.
This event is sent when a user enters text in a textbox
. This event is only called when the text displayed would change, thus it is not called when the user presses non-displayable keys.
Connects the element 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 element.
If set to true, then the user cannot change the value of the element. However, the value may still be modified by a script.
The number of rows to display in the element. If the element contains more than this number of rows, a scrollbar will appear which the user can use to scroll to the other rows. To get the actual number of rows in the element, use the getRowCount
method.
The number of characters that can be displayed in the textbox.
New in Firefox 2.0.0.2!
If true, spell checking is enabled by default for the text box; if false, spell checking is disabled by default.
If not specified, this defaults to false
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 sequence.
For timed textboxes, the number of milliseconds before the timer fires a command event. The timer starts after the user types a character. If the user types another character, the timer resets.
The default value entered in a textbox. The attribute only holds the default value and is never modified when the user enters text. To get the updated value, use the value
property. For number boxes, the default is 0 or the minimum value returned by the min property, whichever is higher.
Set this attribute to the value off to disable word wrapping in the textbox. If this attribute is not specified, word wrapping is enabled.
New in Firefox 3!
If true, the value of the number box will wrap around when the maximum or minimum value is exceeded. The minimum and maximum values must both not be infinity.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
Indicates whether to show the seconds field.
If set to true, then the user cannot change the value of the element. However, the value may still be modified by a script.
Indicates the number of minutes to skip each time the arrows are pressed. This should be used in combination with setting hideseconds to true.
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 sequence.
The initial value of the timepicker in either the form HH:MM:SS or HH:MM.
Firefox only!
The current set of displayed items on the toolbar . This will be modified when the user customizes the toolbar. The value of this attribute should be a comma-separated list of item IDs from the toolbarpalette or, additionally, any of the following strings: "separator", "spring", "spacer".
Firefox Only
Set this attribute to true on toolbar s that can be customized. This causes the set of buttons to be persisted across sessions.
Firefox only!
The default set of displayed items on the toolbar . This should be set to a comma-separated list of item IDs from the toolbarpalette . For example, back-button,forward-button,print-button.
Not in Firefox!
When set to true, the grippy will be hidden. When set to false, the default, the grippy will be shown.
Not in Firefox!
The text to appear on the tooltip for the toolbar 's grippy when the toolbar is collapsed. This would be used to label the grippy so that the user knows which toolbar it represents.
Firefox Only!
How the toolbarbutton s on the toolbar are displayed.
* icons: Show only icons.
* text: Show only text.
* full: Show both.
Firefox only!
The name of the toolbar , which is listed on the Show/Hide toolbars menu.
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 element.
If this attribute is true or left out, the checked state of the button will be switched each time the button is pressed. If this attribute is false, the checked state must be adjusted manually. When autoCheck is true, the button type should be"checkbox" or"radio".
Indicates whether the element is checked or not.
Use hasAttribute() to determine whether this attribute is set instead of getAttribute().
For buttons, the type attribute must be set to checkbox or radio for this attribute to have any effect.
values 0, 1, or 2
This attribute may be used to create three state buttons, numbered 0, 1 and 2. When in state 0 or 1, pressing the button will switch to the opposite state. When in state 2, pressing the button will switch to state 0. This means that the button acts like a checkbox except that there is a third state which must be set manually by adjusting the check state. If you wish to have different behavior for how the states are adjusted, set the autoCheck attribute to false and adjust the state with a script. The type attribute must be set to checkbox for buttons with a check state.
Set to the id of a command
element that is being observed by the element.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
Buttons with type="radio" and the same value for their group attribute are put into the same group. Only one button from each group can be checked at a time. If the user selects one the buttons, the others in the group are unchecked.
The URL of the image to appear on the element. If this attribute is empty or 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 element. If this is left out, no text appears.
For the menu type buttons, the open attribute is set to true when the menu is open. The open attribute is not present if the menu is closed.
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 sequence.
The type of button. If this attribute is not present, a normal button is created. You can set this attribute to the value menu to create a button with a menu popup. This will typically cause the button to be displayed differently.
If true, the tooltip
is used as the default popup for displaying tooltips in the window.
The label that will appear on the element. If this is left out, no text appears.
If this attribute is set to false or omitted, the tooltip
will automatically disappear after a few seconds. If this attribute is set to true, this will not happen and the tooltip will only hide when the user moves the mouse to another element.
This event is sent to a popup after it has been hidden.
This event is sent to a popup when it is about to be hidden.
This event is sent to a popup just before it is opened. This handler is usually used to dynamically set the contents when the user requests to display it. Returning false from this event handler prevents the popup from appearing.
This event is sent to a popup after it has been opened, much like the onload event is sent to a window when it is opened.
New in Firefox 3!
Specify background color of the window's titlebar when it is active (foreground). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
true if the wizard
is on the first page.
New in Firefox 3!
Specify background color of the window's titlebar when it is inactive (background). Moreover this hides separator between titlebar and window contents. This affects only on Mac OS X.
True if the wizard
is on the last page.
This should be set to code which is called when the user presses the extra1 button.
This should be set to code which is called when the user presses the extra2 button.
This should be set to code which is called when the user presses the Back button. Return true to allow the previous page to be displayed and false to disallow moving back a page. Use the canRewind
property to indicate to the user (by disabling the Back button) that they cannot go back a page.
This should be set to code which is called when the user presses the Cancel button. Return true to allow the wizard to be cancelled, and close the wizard, or return false to prevent the wizard from being cancelled.
This should be set to code which is called when the user presses the Finish button, which would appear in place of the Next button on the last page of the wizard. Return true to allow the wizard to be closed, accepting any values entered on the pages, or return false to prevent the wizard from being closed. Use the canAdvance
property to indicate to the user (by disabling the Finish button) that they cannot end the wizard.
This should be set to code which is called when the user presses the Next button. Return true to allow the next page to be displayed and false to disallow moving to the next page. Use the canAdvance
property to indicate to the user (by disabling the Next button) that they cannot go to the next page.
The index of the current page.
The text to appear in the title bar of the window.
Set to a string which can be used to identify the type of window. This might be used, for example, to distinguish between a browser window and an editor window. Some of Mozilla's window handling functions use this attribute to group windows of the same type together.
Descriptive text to appear in addition to the dialog title.
The label that will appear on the element. If this is left out, no text appears.
Set to the pageid of the next page after this one. When set, the page with this pageID is displayed when the Next button is pressed. This can be used to create wizards that do not have a linear sequence. If one of the pages has a next attribute, all of the pages should have one, except that last page.
This should be set to code which is called when the user presses the Next button while on the current page. Return true to allow the next page to be displayed and false to disallow moving to the next page.
The code in this attribute is called when the page is hidden, such as when moving to another page. Return true to accept the page change and false to prevent the page from changing. This code is called before the wizard
's onwizardnext and related functions.
This should be set to code which is called when the user presses the Back button while on the current page. Return true to allow the previous page to be displayed and false to disallow moving to the previous page.
The code in this attribute is called when the page is shown.
This attribute should be set to a string that identifies the page's identifer in the wizard . This is used with the next attribute. The wizard always starts with the wizardpage that appears first in the wizard child list.
Indicates whether the element is disabled or not. If this element is set to true the element is disabled. Disabled elements are usually drawn with grayed-out text. If the element is disabled, it does not respond to user actions, it cannot be focused, and the command event will not fire.
If this attribute is not used, the user can navigate to specific items within the element by pressing keys corresponding to letters in the item's label. This is done incrementally, so typing more letters with select more specific items. This feature may be disabled by setting this attribute to true.
Indicates that the cells of the tree
may be edited.
When set to true, the user may drag the column headers around to change the order in which they are displayed.
When set to false, a drop-down will appear in the upper right corner of the tree
, which the user may use to show and hide columns. When set to true, the column picker will be hidden. The default value is false.
This event is sent to a tree
when a row is selected, or whenever the selection changes. The user can select multiple rows by holding down Shift or Control and clicking on a row. The onselect event will be sent for each item added to or removed from the selection.
The number of rows to display in the element. If the element contains more than this number of rows, a scrollbar will appear which the user can use to scroll to the other rows. To get the actual number of rows in the element, use the getRowCount
method.
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 sequence.
If true, the background of the tree 's rows will alternate between two colors.
Set to true if the element is a container that contains no children. This will be set by the template builder as needed.
For template-generated content, the attribute should be placed on the element where content generation should begin. Thus, it should be placed on an element that is a descendant of a template. The value should be set to rdf:*.
For tree
s with only a single column, the label may be placed directly on the treeitem
without the need for a treerow
and treecell
inside.
For the menu type buttons, the open attribute is set to true when the menu is open. The open attribute is not present if the menu is closed.
Space-separated list of property names
Sets the properties of the element, which can be used to style the element. For more information, see Styling a Tree.
URI of an RDF resource
For template-generated elements, this attribute is used to specify the root RDF node where content generation begins. This will correspond to the value of an about attribute on an RDF container. This attribute should be placed alongside the datasources attribute.
Allows the contents of individual cells in the column to be changed, especially useful when <treecol type="checkbox">. Also useful for disabling editing of individual treecells. When the user double-clicks an editable cell, a text field appears in which the user can edit the contents of the cell.
The label that will appear on the element. If this is left out, no text appears.
Set this to the URL of an image to appear in the tree cell. If this attribute is left out, no image appears. You can have both an image and a label.
The string attribute allows you to associate a data value with an element. It is not used for any specific purpose, but you can access it with a script for your own use.
The text for the tooltip on the column picker.
The preferred width of the tree column. The value should not include a unit as all values are in pixels. Specifying widths for your columns causes Gecko to allow the tree to be scrolled horizontally if it is wider than the available space.
If true, then the column is a cycler column. In the case, clicking on a cell in the column will alternate its state between on and off. This is used, for example, in a mail window, for a column that indicates that the message is read or unread with a small mark in the cell. If the cycler attribute is not set, the cell is a regular text cell.
This attribute will be set to true if the column is being dragged. This attribute is set automatically; you shouldn't adjust it yourself.
Allows the contents of cells in the column to be changed, especially useful when type="checkbox". When the user double-clicks an editable cell, a text field appears in which the user can edit the contents of the cell.
If true, the size of the column in the tree cannot be adjusted by the user. Any splitter
to either side will resize those columns while keeping the fixed column at a constant size. If false or not specified, the user can adjust the size of the column, typically by dragging the column header with the mouse.
Set this to true to indicate that the tree column header should be displayed without any column header styling. If you don't set a label for that column either, the header is not displayed at all.
If true, the column does not appear in the column picker.
The label that will appear on the element. If this is left out, no text appears.
If set to true, the treecol
will have indentation and twisties drawn to the left of it to indicate the hierarchy level of the rows. If no column has the primary attribute set to true, the tree
may still contain nested rows, although no indication will be given to the user.
URI of an RDF predicate or XML attribute
Set this to a RDF property or XML attribute to have the data in the column sorted based on that property. The property will usually be the same as that of the cell label.
This should be set to true for the column which should be sorted by default.
Set this attribute to have the treecol
element use an image for the header instead of a label . You cannot have both an image and a label displayed in the header. Set this to the URL of an image to appear on the tree column header. If this attribute is left out, no image appears and the label is used instead. The class treecol-image
must be used on the treecol
element for the image to appear. You should still specify a label for use in the column picker if ignoreincolumnpicker is not true and hidecolumnpicker is not true on the tree
.
space-separated list of property names
Sets the properties of the element, which can be used to style the element. For more information, see Styling a Tree.