(Showing Draft Content)

DataTransfer Class

DataTransfer Class

Object used to hold the data that is being dragged during drag and drop operations.

It may hold one or more data items of different types. For more information about drag and drop operations and data transfer objects, see HTML Drag and Drop API.

This object is created automatically by the DragDropTouch singleton and is accessible through the {@link dataTransfer} property of all drag events.


  • DataTransfer



dropEffect: string

Gets or sets the type of drag-and-drop operation currently selected. The value must be 'none', 'copy', 'link', or 'move'.


effectAllowed: string

Gets or sets the types of operations that are possible. Must be one of 'none', 'copy', 'copyLink', 'copyMove', 'link', 'linkMove', 'move', 'all' or 'uninitialized'.


types: string[]

Gets an array of strings giving the formats that were set in the dragstart event.



  • clearData(type?: string): void
  • Removes the data associated with a given type.

    The type argument is optional. If the type is empty or not specified, the data associated with all types is removed. If data for the specified type does not exist, or the data transfer contains no data, this method will have no effect.


    • Optional type: string

      Type of data to remove.

    Returns void


  • getData(type: string): string
  • Retrieves the data for a given type, or an empty string if data for that type does not exist or the data transfer contains no data.


    • type: string

      Type of data to retrieve.

    Returns string


  • setData(type: string, value: string): void


  • setDragImage(img: HTMLElement, offsetX: number, offsetY: number): void
  • Set the image to be used for dragging if a custom one is desired.


    • img: HTMLElement

      An image element to use as the drag feedback image.

    • offsetX: number

      The horizontal offset within the image.

    • offsetY: number

      The vertical offset within the image.

    Returns void