DataTransferItem.getAsString()
The DataTransferItem.getAsString()
method invokes the given callback with the drag data item's string data as the argument if the item's kind
is a Plain unicode string (i.e. kind
is string
).
Syntax
JavaScript
Copy Code
dataTransferItem.getAsString(callback);
Parameters
callback
- A callback function that has access to the
data transfer item's
string data. See Callback below for details.
Return value
Callback
The callback parameter is a callback function which accepts one parameter:
DOMString
- The drag data item's string data.
The callback return value is undefined
.
Example
This example shows the use of the getAsString()
method as an inline function in a drop
event handler.
JavaScript
Copy Code
function drop_handler(ev) { console.log("Drop"); ev.preventDefault(); var data = event.dataTransfer.items; for (var i = 0; i < data.length; i += 1) { if ((data[i].kind == 'string') && (data[i].type.match('^text/plain'))) { // This item is the target node data[i].getAsString(function (s){ ev.target.appendChild(document.getElementById(s)); }); } else if ((data[i].kind == 'string') && (data[i].type.match('^text/html'))) { // Drag data item is HTML console.log("... Drop: HTML"); } else if ((data[i].kind == 'string') && (data[i].type.match('^text/uri-list'))) { // Drag data item is URI console.log("... Drop: URI"); } else if ((data[i].kind == 'file') && (data[i].type.match('^image/'))) { // Drag data item is an image file var f = data[i].getAsFile(); console.log("... Drop: File "); } } }
Specifications
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard The definition of 'getAsString()' in that specification. |
Living Standard | Initial definition. |
HTML5.1 The definition of 'getAsString()' in that specification. |
Working Draft | Snapshot fo HTML WHATWG document |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 4 | 50 (50) | No support | 12 | No support |
Feature | Android | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|---|
Basic support | No support | No support | No support | 50 (50) | No support | No support | No support | No support |
See also
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/datatransferitem/getasstring