Mozilla XUL Element and Script Reference

Contents  Quick Reference

Box

A container element which can contain any number of child elements. If the box has an orient attribute that is set to horizontal, the child elements are laid out from left to right in the order that they appear in the box. If orient is set to vertical, the child elements are laid out from top to bottom. Child elements do not overlap. The default orientation is horizontal.

Attributes:

Attributes inherited from XUL Element


align

Determines the horizontal alignment of the children of the box.

autostretch

In the box is placed inside a horizontally oriented box, autostretch determines whether the box stretches vertically to fit the given space. For vertically oriented boxes, determines whether the box stretches horizontally to fit the given space. Stetching in the opoosite direction is controlled with the flex attribute.

collapsed

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

crop

If the label of the box 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.

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 box. Flexible elements grow and shrink to fit their given space. The actual value is not relevant unless there are other flexible elements with-in 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 box in pixels. It is recommended to use the CSS height property instead.

left

For elements placed within a bulletinboard, specifies the position of the left edge of the box.

orient

Used to specify whether the children of the box element are oriented horizontally or vertically.

top

For elements placed within a bulletinboard, specifies the position of the top edge of the box.

valign

Determines the vertical alignment of the children of the box.

width

The width of the box in pixels. It is recommended to use the CSS width property instead.