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, an indeterminate progressmeter
may be created by setting the mode
attribute to undetermined
. This is used when the length of time to complete an operation is not known beforehand.
More information is available in the XUL tutorial.
- Properties
- accessibleType, max, mode, value
Examples

<progressmeter mode="determined" value="82"/> <progressmeter mode="undetermined"/>
<!-- switching modes while the mouse is over a button --> <progressmeter mode="determined" id="myProgress"/> <button label="Example" onmouseover="setLoading(true)" onmouseout="setLoading(false)"/> function setLoading(state){ document.getElementById('myProgress').mode = (state)Ā ? 'undetermined'Ā : 'determined'; }
Attributes
max
- Type: integer
- The maximum value that progressmeter may have. The default value if not specified is 100 such that the value may be used as a percentage.
mode
- Type: one of the values below
- A
determined
progressmeter
is used in cases where you know how long an operation will take. Anundetermined
progressmeter
can be used when you don't and will typically be drawn as a spinning 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 indeterminate.
value
- Type: integer
- An integer ranging from 0 to the maximum value that indicates the progress. For instance, if no maximum value has been set, setting the value to "0" shows an empty bar, "100" shows a bar at full length and "25" shows the first quarter of the bar.
Inherited from XUL element |
Properties
-
accessibleType
- Type: integer
- A value indicating the type of accessibility object for the element.
-
value
- Type: string
-
Gets and sets the value of the
value
attribute. Fortextbox
and user editablemenulist
elements, the contents, as visible to the user, are read and set using theTextbox.value
and Menulist.value syntax.
Ā
Inherited Properties |
Methods
Related
- Interfaces
nsIAccessibleProvider