DataTransfer: addElement() method
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.
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
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.