Mozilla XUL Element and Script Reference

Contents  Quick Reference

Outlinercol

Describes a column within an outliner. Each outlinercol element is used for each successive column.

Attributes:

Attributes inherited from XUL Element

align

The align attribute specifies how child elements of the box are aligned, when the size of the box is larger than the total size of the children. For boxes that have horizontal orientation, it specifies how its children will be aligned vertically. For boxes that have vertical orientation, it is used to specify how its children are algined horizontally. The pack attribute is related to the alignment but is used to specify the position in the opposite direction. You can also specify the value of align using the style property '-moz-xul-box-align'.

autostretch

(Deprecated) For a outlinercol with horizontal orientation, autostretch determines whether its children stretch vertically to fit the given space. If the outlinercol has vertical orientation, it determines whether the children stretch horizontally to fit the given space. Stetching in the opoosite direction is controlled with the flex attribute on the child element. The attribute has been replaced with align='stretch'.

collapsed

If true, then the outlinercol is collapsed and does not appear. It is equivalent to setting the CSS visibility property to collapsed.

crop

If the label of the outlinercol 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 placed in place of the cropped text.

cycler

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 im a mail window, for a column that indicates that the message is read or unread with a small mark in the cell. If false, the cell is a regular text cell.

debug

If true, extra borders are drawn around the element and all its descendants. This can be used to determine orientation and where flexible elements are. If debug mode is enabled for a box, horizontal oriented boxes are displayed with a blue border and vertical boxes are displayed with a red border. The border above the element will be straight for non-flexible elements and wavy for flexible elements.

flex

Indicates the flexibility of the outlinercol. Flexible elements grow and shrink to fit their given space. The actual value is not relevant unless there are other flexible elements within the same container. Elements with larger flex values will grow more than elements with lower flex values, at the ratio determined by the two elements.

height

The height of the outlinercol in pixels. It is recommended that the CSS height property be used instead.

hidden

This attribute, when set to true, hides the column. The user can show the column by selecting it from a drop-down at the end of the column header row.

label

The label that will appear on the outlinercol. If this is left out, no text appears.

orient

Used to specify whether the children of the outlinercol element are oriented horizontally or vertically. You can also use the '-moz-xul-box-orient' style property.

pack

The pack attribute specifies where child elements of the box are placed when the box is larger that the size of the children. For boxes with horizontal orientation, it is used to indicate the position of children horizontally. For boxes with vertical orientation, it is used to indicate the position of children vertically. The align attribute is used to specify the position in the opposite direction. You can also specify the value of pack using the style property '-moz-xul-box-pack'.

primary

If set to true, the column 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 will not contain any nested rows.

sort

Set this to a RDF property to have the data in the column sorted based on that property. The property will generally be the same as that of the cell labels.

sortActive

This should be set to true for the column which should be sorted by default.

sortDirection

Set this attribute to set the direction the column is sorted. The user may change the sort direction by clicking the column headers.

valign

(Deprecated) Determines the vertical alignment of the children of the outlinercol.

width

The width of the outlinercol in pixels. It is recommended that the CSS width property be used instead.

JavaScript Properties and Methods:

Properties and Methods inherited from XUL Element