JavaScript: The Definitive Guide, 6th Edition

Name

Progress — a progress bar

Inherits from

Node, Element

Synopsis

A Progress object represents an HTML <progress> element and displays a graphical representation of progress toward the completion of some kind of task.

When the amount of work or time required to complete the task is not known, the Progress element is said to be in an indeterminate state. In this state, it simply displays some kind of “working” animation to indicate that something is happening. When the total amount of work (or time or bytes) and the amount accomplished are known, the Progress element is a determinate state and can display progress with some kind of completion percentage graphic.

<progress> is an HTML5 element that, at the time of this writing, is not yet widely supported.

Properties

readonly Form form

The Form element, if there is one, that is the ancestor of this element or that was identified with the HTML form attribute.

readonly NodeList labels

An array-like object of Label elements that are associated with this element.

double max

The total amount of work to be done. When using a Progress element to display upload or download progress of an XMLHttpRequest, for example, you might set this property to the total number of bytes to be transferred. This property mirrors the max attribute. The default value is 1.0.

readonly double position

If this is a determinate Progress element, this property is the computed value value/max. Otherwise this property will be -1.

double value

A value between 0 and max indicating ...