Mozilla XUL Element and Script Reference

Contents  Quick Reference

Menupopup

A container used to display menus. It should be placed inside a menu, menulist, or menubutton element. It can contain any element but usually will contain menuitem elements. It is a type of box that defaults to vertical orientation.

Attributes:

Attributes inherited from XUL Element


align

Determines the horizontal alignment of the children of the menupopup.

autostretch

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

crop

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

orient

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

top

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

valign

Determines the vertical alignment of the children of the menupopup.

width

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