DataTransfer
Передача данных в операциях драгндроп мышью
dropEffect
Это свойство определяет тип передачи данных, представленных этим объектом.
Свойство должно иметь одно из значений: «none», «copy», «move» или «link». Как правило, объект-приемник устанавливает это свойство в обработчике события «dragenter» или «dragover». Значение этого свойства может также зависеть от клавиш модификаторов, удерживаемых пользователем в процессе буксировки, но это во многом зависит от платформы.
effectAllowed
Это свойство определяет допустимую комбинацию операций перемещения из числа: копирование, перемещение и создание ссылки. Это свойство обычно устанавливается источником в ответ на событие «dragstart». Допустимыми значениями являются: «none» (ни одна), «copy» (копирование), «copyLink» (копирование и создание ссылки), «copyMove» (копирование и перемещение), «link» (создание ссылки), «linkMove» (создание ссылки и перемещение), «move» (перемещение) и «all»(все).
files
Если перемещаемые данные являются одним или более файлами, это свойство будет ссылаться на массив или на объект, подобный массиву, содержащий объекты File.
types
Это объект, подобный массиву, содержащий строки, которые определяют MIME-типы данных, сохраняемых в объекте DataTransfer (устанавливается методом set Data(), если источник располагается в броузере, или каким-либо другим механизмом, если источник находится за пределами броузера). Объект, подобный массиву, хранящий типы, должен иметь метод contains() для проверки присутствия определенной строки. Однако некоторые броузеры передают в этом свойстве истинный массив, и в этом случае для проверки можно использовать метод indexOf().
addElement
(Element element)Сообщает броузеру элемент element, который можно использовать для воспроизведения визуального эффекта, который будет наблюдать пользователь во время буксировки. Обычно этот метод вызывается буксируемым источником, но он может быть реализован или иметь хоть какой-нибудь эффект не во всех броузерах.
clearData
([string format])Удаляет все данные в формате format, которые были добавлены методом setData().
getData
(string format)Возвращает отбуксированные данные в формате format. Если в аргументе format передано значение «text» (без учета регистра символов), возвращаются данные в формате «text/plain». А если передано значение «url» (без учета регистра симво лов), возвращаются данные в формате «text/uri-list». Этот метод вызывается при емником в ответ на событие «drop» в конце операции буксировки.
setData
(string format, string data)Принимает данные data для передачи и MIME-тип этих данных в аргументе format.
Источник вызывает этот метод в ответ на событие «dragstart» в начале операции буксировки. Он не может вызываться из какого-либо другого обработчика событий. Если источник способен представить данные более чем в одном формате, он может вызвать этот метод несколько раз, чтобы определить значения для каждого поддерживаемого формата.
setDragImage
(Element image, long x, long y)Определяет изображение image (обычно элемент <img>), которое должно отображаться как визуа льное представление буксируемых данных. Аргументы x и y определяют смещение указателя мыши относительно изображения. Этот метод может вызываться только буксируемым источником, в ответ на событие «dragstart».