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

Флэнаган Дэвид
Шрифт:

readonly File[] files

Если перемещаемые данные являются одним или более файлами, это свойство будет ссылаться на массив или на объект, подобный массиву, содержащий объекты

File
,

readonly string[] types

Это объект, подобный массиву, содержащий строки, которые определяют MIME-типы данных, сохраняемых в объекте

DataTransfer
(устанавливается методом
setData,
если источник располагается в броузере, или каким-либо другим механизмом, если источник находится за пределами броузера). Объект, подобный массиву, хранящий типы, должен иметь метод
contains
для проверки присутствия определенной строки. Однако некоторые броузеры передают в этом свойстве истинный массив, и в этом случае для проверки можно использовать метод
indexOf.

Методы

void addElement(Element element)

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

void clearData([string format])

Удаляет все данные в формате format, которые были добавлены методом

setData
.

string getData(string format)

Возвращает отбуксированные данные в формате format. Если в аргументе format передано значение «text» (без учета регистра символов), возвращаются данные в формате «text/рlаіп». А если передано значение «url» (без учета регистра символов), возвращаются данные в формате «text/uri-list». Этот метод вызывается приемником в ответ на событие «drop» в конце операции буксировки.

void setData(string format, string data)

Принимает данные

data
для передачи и МІМЕ-тип этих данных в аргументе format. Источник вызывает этот метод в ответ на событие «dragstart» в начале операции буксировки. Он не может вызываться из какого-либо другого обработчика событий. Если источник способен представить данные более чем в одном формате, он может вызвать этот метод несколько раз, чтобы определить значения для каждого поддерживаемого формата,

void setDragImage(Element image, long x, long y)

Определяет изображение

image
(обычно элемент
<img>
), которое должно отображаться как визуальное представление буксируемых данных. Аргументы х и у определяют смещение указателя мыши относительно изображения. Этот метод может вызываться только буксируемым источником, в ответ на событие «dragstart».

DataView

реализует чтение/запись значений в ArrayBuffer (ArrayBufferView)

DataView
– это подтип
ArrayBufferView
, который служит оберткой для
ArrayBuffer
(или фрагмента
ArrayBuffer
) и определяет методы чтения/записи 1-, 2- и 4-байтовых целых со знаком и без знака, а также 4- и 8-байтовых вещественных чисел в буфере. Методы поддерживают прямой (big-endian) и обратный (little-endian) порядок следования байтов. См. также
TypedArray
.

Конструктор

new DataView(ArrayBuffer buffer, [unsigned long byteOffset], [unsigned long byteLength])

Этот конструктор создает новый объект

DataView
, обеспечивающий доступ на чтение и запись к байтам в буфере или во фрагменте буфера. При вызове с одним аргументом создает представление всего буфера. При вызове с двумя аргументами создает представление, простирающееся от байта с номером byteOffset до конца буфера. И при вызове с тремя аргументами создает представление длиной byteLength, начинающееся с байта с номером byteOffset.

Методы

Следующие методы читают или записывают числовые значения в буфер

ArrayBuffer
, представленный объектом
DataView
. Имя метода определяет тип читаемого или записываемого числового значения. Все методы, выполняющие чтение или запись более одного байта, принимают необязательный последний аргумент littleEndian. Если этот аргумент отсутствует или имеет значение false, используется прямой (big-endian) порядок следования байтов, когда старшие байты читаются или записываются первыми. Однако если этот аргумент имеет значение true, используется обратный (little-endian) порядок следования байтов.