Книга: JavaScript. Подробное руководство, 6-е издание

Progress

Progress

индикатор хода выполнения операции (Node, Element)

Объект Progress представляет HTML-элемент <progress> и отображается как графический индикатор хода выполнения некоторой операции.

Когда заранее общий объем работы или времени на ее выполнение неизвестен, говорят, что элемент Progress находится в неопределенном состоянии. В таком состоянии он просто отображает некоторую «рабочую» анимацию, чтобы показать, что операция выполняется. Когда общий объем работы (в единицах времени или в байтах) известен заранее, элемент Progress находится в определенном состоянии и может отображать ход выполнения операции в процентах в виде некоторого графического представления.

Элемент <progress> введен спецификацией HTML5, поэтому на момент написания этих строк он был реализован не во всех броузерах.

Свойства

readonly Form form

Элемент Form, если имеется, являющийся предком для данного элемента или определяемый HTML-атрибутом form.

readonly NodeList labels

Объект, подобный массиву, содержащий элементы Label, связанные с этим элементом.

double max

Общий объем работы, который требуется выполнить. Например, при использовании элемента Progress для отображения хода операции выгрузки или загрузки, выполняемой объектом XMLHttpRequest, в это свойство можно записать общее количество байтов, которые требуется передать. Данное свойство соответствует HTML-атрибуту max. По умолчанию имеет значение 1.0.

readonly double position

Если элемент Progress находится в определенном состоянии, данное свойство содержит значение выражения value/max. Иначе оно будет иметь значение -1.

double value

Значение между 0 и max, определяющее уже выполненный объем работы. Это свойство соответствует HTML-атрибуту value. Если этот атрибут определен, элемент Progress находится в определенном состоянии. Если он отсутствует, элемент Progress находится в неопределенном состоянии. Чтобы переключиться из определенного в неопределенное состояние (например, потому что проигрыватель MediaElement получил событие «stalled») можно воспользоваться методом removeAttribute() интерфейса Element.

Оглавление книги