DataTransfer

Объект DataTransfer используется для хранения любых данных, передаваемых между контекстами, например, при операции перетаскивания или чтении/записи буфера обмена. Он может содержать один или несколько элементов данных, каждый из которых может иметь один или несколько типов данных.

DataTransfer был в первую очередь разработан для API перетаскивания и перемещения HTML, как свойство DragEvent.dataTransfer, и до сих пор определен в разделе HTML перетаскивания, но теперь он также используется другими API, такими как ClipboardEvent.clipboardData и InputEvent.dataTransfer. Однако другие API используют только определенные части его интерфейса, игнорируя свойства, такие как dropEffect. Документация DataTransfer в основном будет обсуждать его использование в операциях перетаскивания, и вы должны обратиться к документации других API для использования DataTransfer в этих контекстах.

DataTransfer()

Создаёт и возвращает новый объект DataTransfer.

DataTransfer.dropEffect

Получает тип операции перетаскивания, выбранной в настоящее время, или устанавливает операцию на новый тип. Значение должно быть none, copy, link или move.

DataTransfer.effectAllowed

Предоставляет все типы операций, которые возможны. Должно быть одним из none, copy, copyLink, copyMove, link, linkMove, move, all или uninitialized.

DataTransfer.files Только для чтения

Содержит список всех локальных файлов, доступных в передаче данных. Если операция перетаскивания не включает перетаскивание файлов, это свойство является пустым списком.

DataTransfer.items Только для чтения

Предоставляет объект DataTransferItemList, который является списком всех данных перетаскивания.

DataTransfer.types Только для чтения

Массив строк, указывающий форматы, установленные в событии dragstart.

DataTransfer.addElement() Экспериментальный Нестандартный

Устанавливает исходный элемент перетаскивания для данного элемента. Это будет тот элемент, для которого срабатывают события drag и dragend, а не стандартный целевой элемент (узел, который был перетащен). Специфично для Firefox.

DataTransfer.clearData()

Удаляет данные, связанные с заданным типом. Аргумент type необязателен. Если type пустой или не указан, удаляются данные, связанные со всеми типами. Если данных для указанного типа не существует или передача данных не содержит данных, этот метод не повлияет.

DataTransfer.getData()

Извлекает данные для заданного типа или пустую строку, если данных для этого типа не существует или передача данных не содержит данных.

DataTransfer.setData()

Устанавливает данные для данного типа. Если данные для типа не существуют, они добавляются в конец, так что последний элемент в списке types будет новым форматом. Если данные для типа уже существуют, существующие данные заменяются на том же месте.

DataTransfer.setDragImage()

Устанавливает изображение, используемое для перетаскивания, если необходимо использовать пользовательское изображение.

Каждая функция и свойство, указанные в этом документе, имеют свою страницу справки, и каждая страница справки либо напрямую включает пример интерфейса, либо содержит ссылку на пример.

• Перетаскивание
• Операции перетаскивания
• Рекомендуемые типы перетаскивания
• Тест DataTransfer - Вставка или перетаскивание