RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://webplatform.github.io/docs/dom/DataTransfer/clearData below:

clearData · WebPlatform Docs

clearData Summary

Removes one or more data formats (or all data) from the clipboard through the DataTransfer object or the ClipboardData object.

Method of dom/DataTransfer dom/DataTransfer

Syntax

 event.dataTransfer.clearData(format);

Parameters format

Data-type: String

(Optional)

The format of the data to be cleared, using one of the following values (case insensitve):

URL
Text

If format is omitted, all data is removed.

Return Value

No return value

Examples

This example uses the clearData, setData, and getData methods with the DataTransfer object.

<!doctype html>
<html>
 <head>
  <script>
var sImageURL, oTarget, oImage;
function initiateDrag(e) {

  e.dataTransfer.setData("URL", oImage.src);
}
function finishDrag(e) {
  e.dataTransfer.clearData("URL");
  oTarget.textContent = e.dataTransfer.getData("URL");
}
function initialize() {
 oImage = document.getElementById("oImage");
 oTarget = document.getElementbyId("oTarget");
 oImage.addEventListener("dragstart", initiateDrag, false);
 oTarget.addEventListener("dragenter", finishDrag, false);
}
window.addEventListener("load", initialize, false);
  </script>
 </head>
 <body>
  <p>This example demonstrates how to use the setData and getData methods of the dataTransfer object to enable the source path of the image to be dragged. Since we are clearing the data, dragging over the target will show "null" instead.</p>
  <img id="oImage" src="/workshop/graphics/black.png" width="20" height="20" alt="Black">
  <span id="oTarget">
    Drop the image here
  </span>
 </body>
</html>

View live example

Notes

If no format parameter is passed, all of the data formats are cleared.
For drag-and-drop operations, the clearData method of the DataTransfer object is used generally in source events, such as dragstart. When you override the default behavior of the target, use clearData in the drop event. It is particularly useful for selectively removing data formats when multiple formats are specified.
The clearData() method does not affect whether any files were included in the drag, so the types attribute’s list might still not be empty after calling clearData() (it would still contain the “Files” string if any files were included in the drag).

Related specifications

HTML5: Candidate Recommendation

Attributions

Microsoft Developer Network: [Windows Internet Explorer API reference Article]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4