« XUL Reference home [ Examples | Attributes | Properties | Methods | Related ]

A container used to display a set of tabbed pages of elements. A row of tabs is displayed at the top of tabbox which may be used to switch between each page. The tabbox should contain two children, the first a tabs element which contains the tabs and the second a tabpanels element which contains the contents of the pages.

More information is available in the XUL tutorial.

Attributes
eventnode, handleCtrlPageUpDown, handleCtrlTab
Properties
accessibleType, eventNode, handleCtrlPageUpDown, handleCtrlTab, selectedIndex, selectedPanel, selectedTab, tabs, tabpanels

Examples

<tabbox id="myTabList" selectedIndex="2">
  <tabs>
    <tab label="A First tab"/>
    <tab label="Second tab"/>
    <tab label="Another tab"/>
    <tab label="Last tab"/>
  </tabs>
  <tabpanels>
    <tabpanel><!-- tabpanel First elements go here --></tabpanel>
    <tabpanel><!-- tabpanel Second elements go here --></tabpanel>
    <tabpanel><button label="Click me"/></tabpanel>
    <tabpanel><!-- tabpanel Fourth elements go here --></tabpanel>
  </tabpanels>
</tabbox>

Image:XUL_REF_tabboxes.gif

Attributes

eventnode
Type: one of the values below
Indicates where keyboard navigation events are listened to. If this attribute is not specified, events are listened to from the tabbox. Thus, if this attribute is not used, the tabbox or an element inside it must have the focus for the keyboard navigation to apply.
parent
Keyboard navigation is captured at the parent of the tabbox.
window
Keyboard navigation is captured at the window level. Tab navigation will occur as long as any element in the window is focused.
document
Keyboard navigation is captured at the document level. Tab navigation will occur as long as any element in the document is focused.
handleCtrlTab
Type: boolean
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.

Properties

accessibleType
Type: integer
A value indicating the type of accessibility object for the element.
eventNode
Type: EventTarget
Indicates the node where keyboard navigation events listener is set up. The initial value for this property is determined by the value of the eventnode attribute.
handleCtrlPageUpDown
Type: boolean
Gets and sets the value of the handleCtrlPageUpDown attribute.
handleCtrlTab
Type: boolean
Gets and sets the value of the handleCtrlTab attibute.
selectedIndex
Type: integer
Returns the index of the currently selected item. You may select an item by assigning its index to this property. By assigning -1 to this property, all items will be deselected. Returns -1 if no items are selected
selectedPanel
Type: element
Holds a reference to the currently selected panel within a <tabbox> element. Assigning a value to this property will modify the selected panel. A select event will be sent when the selected panel is changed.
selectedTab
Type: tab element
A reference to the currently selected tab, which will always be one of the tab elements in the tabs element. Assign a value to this property to modify the currently selected tab.
tabs
Type: tabs element
The tabs element contained within the tabbox.
tabpanels
Type: tabpanels element
The tabpanels element contained within the tabbox.

Methods

Inherited Methods
addEventListener(), appendChild(), blur, click, cloneNode(), compareDocumentPosition, dispatchEvent(), doCommand, focus, getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getBoundingClientRect(), getClientRects(), getElementsByAttribute, getElementsByAttributeNS, getElementsByClassName(), getElementsByTagName(), getElementsByTagNameNS(), getFeature, getUserData, hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isDefaultNamespace(), isEqualNode, isSameNode, isSupported(), lookupNamespaceURI, lookupPrefix, normalize(), querySelector(), querySelectorAll(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS(), setUserData
Elements
tabs, tab, tabpanels, tabpanel.