A meter which can be used to display the progress of a lengthy operation. It is drawn as a bar that is filled as the operation completes. In addition, a non-deterministic progressmeter may be created by setting the mode attribute. This is used when the length of time to complete an operation is not known beforehand.

Example:

    <progressmeter mode="determined" value="50%"/>

Attributes inherited from XUL Element

Determines the direction that the progressmeter is filled in.

• horizontal: The progressmeter is filled from left to right.
• vertical: The progressmeter is filled from bottom to top.

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

• never: The progressmeter is never stretched and is displayed at the size specified by its width and height attributes or by the CSS width and height properties.
• always: The progressmeter stretches to fill the given space.

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

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

• left: The text will be cropped on its left side.
• right: The text will be cropped on its right side.
• center: The text will be cropped on both sides.
• none: The text will be not be cropped using an ellipsis. However, the text will simply be cut off if it too large. The side depends on the CSS text alignment.

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.

Indicates the flexibility of the progressmeter. 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.

The height of the progressmeter in pixels. It is recommended to use the CSS height property instead.

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

A determined progressmeter is used in cases where you know how long an operation will take. Undeterminate progressmeters can be used when you don't and will typically be drawn as a animating barber pole.

• determined: The progress meter uses its value attribute to determine the amount of the bar that is filled in.
• undetermined: The progressmeter is undeterminate.

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

• horizontal: Child elements of the progressmeter are placed next to each other in a row in the order that they appear in the XUL source.
• vertical: Child elements of the progressmeter are placed under to each other in a column in the order that they appear in the XUL source.

The label that appears over the progressmeter. If this text is not specified, no label will appear.

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

Determines the vertical alignment of the children of the progressmeter.

• top: Elements are aligned by their top edges.
• middle: Elements are centered vertically.
• bottom: Elements are aligned by their bottom edges.
• baseline: Elements are aligned by their text baseline.

A percentage value that specifies the amount of the meter that is filled in. Because it is a percentage, it ranges from 0 to 100.

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

Properties and Methods inherited from XUL Element

A determined progressmeter is used in cases where you know how long an operation will take. Undeterminate progressmeters can be used when you don't and will typically be drawn as a animating barber pole.

• determined: The progress meter uses its value attribute to determine the amount of the bar that is filled in.
• undetermined: The progressmeter is undeterminate.

The label that appears over the progressmeter. If this text is not specified, no label will appear.

A percentage value that specifies the amount of the meter that is filled in. Because it is a percentage, it ranges from 0 to 100.