dataTransfer object

The dataTransfer object makes it possible to customize the handling of drag-and-drop operations. It is available through the event object.

The dataTransfer object is used in source and target events. Typically, the setData method is used with source events to provide information about the data being transferred. In contrast, the getData method is used with target events to stipulate which data and data formats to retrieve.

This object is available in script as of Microsoft® Internet Explorer 5.

Example

This example uses the setData and getData methods of the dataTransfer object to perform a drag-and-drop operation.

<HEAD>
<SCRIPT>
var sAnchorURL; function InitiateDrag()
/* The setData parameters tell the source object to transfer data as a URL and provide the path. */
{ event. dataTransfer .setData("URL", oSource.href); }
function FinishDrag()
/* The parameter passed to getData tells the target object what data format to expect. */
{ sAnchorURL = event. dataTransfer .getData("URL") oTarget.innerText = sAnchorURL; }
</SCRIPT>
</HEAD>
<BODY>
<A ID=oSource HREF="about:Example_Complete" onclick="return(false)" ondragstart="InitiateDrag()">Test Anchor</A>
<SPAN ID=oTarget ondragenter="FinishDrag()">Drop the Link Here</SPAN>
</BODY>

Standards Information

There is no public standard that applies to this object.

Applies To

[ Object Name ] Platform Version

Win16:
Win32:
Unix:
Mac:
Windows CE:

event

Home | Top | Free Ajax Editor | JavaScript Editor

Get Advanced
JavaScript and Ajax Editor,
Validator and Debugger!
1st JavaScript Editor.

→