Общий объем работы, который требуется выполнить. Например, при использовании элемента
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
.
ProgressEvent
событие продолжения загрузки, выгрузки или чтения файла (Event)
Все объекты -
ApplicationCache, FineReader
и
XMLHttpRequest
(версия 2) - возбуждают события, чтобы известить приложение о ходе выполнения операций передачи данных, таких как загрузка/выгрузка по сети или чтение файла. События этого рода известны как события хода выполнения операции, но только одно из них носит имя «progress». Другие события из этой категории, возбуждаемые объектами
FineReader
и
XMLHttpRequest
, - это события «loadstart», «load», «loadend», «error» и «abort».
Объект
XMLHttpRequest
также возбуждает событие «timeout». Объект
ApplicationCache
возбуждает несколько разных событий, имеющих отношение к ходу выполнения операции и описываемых здесь, но только одно из них носит имя «progress». Эти события возбуждаются в последовательности, которая начинается с события «loadstart» и всегда заканчивается событием «loadend». Непосредственно событию «loadend» предшествует событие «load», «error» или «abort», в зависимости от успеха выполнения операции. Между начальным «loadstart» и двумя заключительными событиями возбуждается ноль или более событий (с названием «progress»). (Объект
ApplicationCache
генерирует иную последовательность событий, но и он возбуждает событие «progress» в ходе обновления кэша, которое также относится к категории событий хода выполнения операции.)
Обработчтки событий хода выполнения операции получают объект
ProgressEvent
, который определяет количество переданных байтов данных. Объект
ProgressEvent
никак не связан с HTML-элементом
<progress>
, описанным в справочной статье
Progress
, но обект
ProgressEvent
, передаваемый (например) обработчику
onprogress
объекта
XMLHttpRequest
, можно было бы использовать для обновления состояния элемента
<progress>
, обеспечивающего визуальное представление хода выполнения операции загрузки.
Свойства
readonly boolean lengthComputable
Имеет значение true, если известно общее количество байтов, предназначенных для передачи, и false - в противном случае. Если это свойство имеет значение true, процент выполнения операции для объекта
е
типа
ProgressEvent
можно вычислить как:
var percentComplete = Math.floor(100*e.loaded/e.total);
readonly unsigned long loaded
Количество уже переданных байтов.
readonly unsigned long total
Общее количество байтов, предназначенных для передачи, если известно, и 0 -в противном случае. Эту информацию можно получить, например, из свойства
size
объекта
Blob
или из заголовка
ContentLength
, возвращаемого веб-сервером.
Screen
предоставляет информацию о дисплее
Свойство
screen
любого объекта
Window
ссылается на объект
Screen
. Свойства этого глобального объекта содержат информацию об экране, на котором отображается броузер. JavaScript-программы могут руководствоваться этой информацией для оптимизации вывода в соответствии с возможностями дисплея пользователя. Например, программа может выбирать между большими и маленькими изображениями в зависимости от размера экрана.
Свойства
readonly unsigned long availHeight
Определяет доступную высоту экрана (в пикселах), на котором отображается вебброузер. Эта доступная высота не включает пространство, занятое постоянно отображаемыми элементами рабочего стола, такими как панель задач в нижней части экрана.
readonly unsigned long availWidth
Определяет доступную ширину экрана в пикселах, на котором отображается вебброузер. Эта доступная ширина не включает пространство, занимаемое постоянно отображаемыми элементами рабочего стола.
readonly unsigned long colorDepth
readonly unsigned long pixelDepth
Эти свойства, являющиеся синонимами, определяют глубину цвета в битах на пиксел.
readonly unsigned long height
Определяет общую высоту экрана в пикселах, на котором отображается веб-броузер. См. также