Home > Element Reference : Tabbox

Contents

### Tabbox

A container used to display tabbed pages of elements to the user. 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. This is a type of box that defaults to vertical orientation.

More information about tabbox

The tabbox element implements the following interfaces:

nsIAccessibleProvider

Attributes:

eventnode | handleCtrlPageUpDown | handleCtrlTab | selectedIndex

Properties and Methods:

accessible | eventNode | handleCtrlPageUpDown | handleCtrlTab | selectedIndex
selectedPanel | selectedTab

#### Attributes:

Inherited from XUL Element:

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

##### eventnode

Type: one of the values below

Indicates from where keyboard navigation events are listened from. 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.

##### handleCtrlPageUpDown

Type: boolean

If set to true or omitted, the tabbox will switch to the next tab when the Control and Page Up or Page Down keys are pressed. If this attribute is set to false, these keys do not navigate between tabs.

##### 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.

##### selectedIndex Mozilla 1.8

Type: integer

Set this attribute to the index of the tab to be selected by default.

#### Properties and Methods:

Inherited from XUL Element:

align
allowEvents
blur
boxObject
boxObject.element
boxObject.getLookAndFeelMetric
boxObject.height
boxObject.screenX
boxObject.screenY
boxObject.width
boxObject.x
boxObject.y
builder
className
click
collapsed
contextMenu
controllers
database
datasources
dir
doCommand
flex
focus
getElementsByAttribute
height
hidden
id
left
maxHeight
maxWidth
menu
minHeight
minWidth
observes
ordinal
orient
pack
persist
ref
resource
statusText
style
tooltip
tooltipText
top
width

Inherited from Element:

addEventListener
appendChild
attributes
childNodes
cloneNode
dispatchEvent
firstChild
getAttribute
getAttributeNS
getAttributeNode
getAttributeNodeNS
getElementsByTagName
getElementsByTagNameNS
hasAttribute
hasAttributeNS
hasAttributes
hasChildNodes
insertBefore
isSupported
lastChild
localName
namespaceURI
nextSibling
nodeName
nodeType
nodeValue
normalize
ownerDocument
parentNode
prefix
previousSibling
removeAttribute
removeAttributeNS
removeAttributeNode
removeChild
removeEventListener
replaceChild
setAttribute
setAttributeNS
setAttributeNode
setAttributeNodeNS
tagName

##### accessible

Type: nsIAccessible

Returns the accessibility object for the tabbox.

##### eventNode

Gets and sets 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 attribute.

##### selectedIndex

Type: integer

Gets and sets the index of the currently selected tab. A non-bubbling select event will be sent to the tabs element when the selection is changed.

##### selectedPanel

Type: tabpanel element

Holds a reference to the currently selected tabpanel. You can assign a value to this property to change the displayed tab.

##### 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.

Copyright (C) 1999 - 2004 XulPlanet.com