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