MDN self-hosted library · e01.org

DataTransfer: addElement() method

HTML Drag and Drop API

HTML Drag and Drop API

The addElement() method of the DataTransfer interface sets the drag source to the given element. This element will be the element to which drag and dragend events are fired, and not the default target (the node that was dragged).

During a drag operation, this method can only be used in the handler for the dragstart event, because that's the only time the drag operation's data store is writable. Calling it from any other drag event throws a NoModificationAllowedError DOMException. See Modifying the drag data store for details.

Syntax

addElement(element)

Parameters

  • element
  • : The Element to set as the drag source.

Return value

None (undefined).

Exceptions

  • NoModificationAllowedError DOMException
  • : Thrown if the drag data store is not in read/write mode.

Examples

This example shows the use of the addElement() method

function changeDragNode(event, node) {
  const dt = event.dataTransfer;
  dt.addElement(node);
}

Specifications

This method is not defined in any Web standard.

Browser compatibility

See also