Entender el Objeto event.dataTransfer
El DataTransfer
objeto se utiliza para contener los datos que se arrastran durante una operación de arrastrar y soltar. Puede contener uno o más elementos de datos, cada uno de uno o más tipos de datos. Para obtener más información sobre arrastrar y soltar.
Este objeto está disponible en dataTransfer
propiedad de todos drag events
.
Constructor
DataTransfer()
Crea y devuelve un nuevo DataTransfer
objeto.
Propiedades de instancia
Propiedades estándar
DataTransfer.dropEffect
Obtiene el tipo de operación de arrastrar y soltar seleccionada actualmente o establece la operación en un nuevo tipo. El valor debe ser none
, copy
o link
.move
Proporciona todos los tipos de operaciones posibles. Debe ser uno de:
none
, copy
, copyLink
, copyMove
, link
, linkMove
, move
o all
.uninitialized
Solo lectura
Contiene una lista de todos los archivos locales disponibles en la transferencia de datos. Si la operación de arrastre no implica arrastrar archivos, esta propiedad es una lista vacía.
DataTransfer.items
Solo lectura
Proporciona un DataTransferItemList
objeto que es una lista de todos los datos de arrastre.
Solo lectura
Una serie de cadenas que indican los formatos establecidos en el dragstart
evento.
Métodos de instancia
Métodos estándar
Elimina los datos asociados a un tipo determinado. El argumento de tipo es opcional. Si el tipo está vacío o no se especifica, se eliminan los datos asociados con todos los tipos. Si los datos para el tipo especificado no existen, o la transferencia de datos no contiene datos, este método no tendrá ningún efecto.
DataTransfer.getData()
Recupera los datos de un tipo determinado, o una cadena vacía si los datos de ese tipo no existen o la transferencia de datos no contiene datos.
DataTransfer.setData()
+ inflo guía oficial setData()
Establezca los datos para un tipo determinado. Si los datos para el tipo no existen, se agregan al final, de modo que el último elemento en la lista de tipos será el nuevo formato. Si ya existen datos para el tipo, los datos existentes se reemplazan en la misma posición.
Transferencia de datos: método setData()
El DataTransfer.setData()
método establece la operación de arrastre drag data
en los datos y el tipo especificados. Si los datos para el tipo dado no existen, se agregan al final del almacén de datos de arrastre, de modo que el último elemento de la types
lista será el nuevo tipo. Si ya existen datos para el tipo dado, los datos existentes se reemplazan en la misma posición. Es decir, el orden de la types
lista no cambia al reemplazar datos del mismo tipo.
Los tipos de datos de ejemplo son text/plain
y text/uri-list
.
Sintaxis
JSCopiar al portapapeles
setData(format, data)
Parámetros
Una cadena que representa el tipo de datos de arrastre que se agregarán al archivo drag object
.data
Una cadena que representa los datos que se agregarán al archivo drag object
.
Valor de retorno
DataTransfer.setDragImage()
Configure la imagen que se utilizará para arrastrar si desea una personalizada.