JavaScript. Подробное руководство, 6-е издание, Флэнаган Дэвид

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

на обложку

Флэнаган Дэвид

Шрифт:

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

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

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

Определяет общую высоту экрана в пикселах, на котором отображается веб-броузер. См. также

availHeight

readonly unsigned long width