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
NoModificationAllowedErrorDOMException- : 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.