Back to Content

DataTransferItem: kind property

files/en-us/web/api/datatransferitem/kind/index.md

latest1.5 KB
Original Source

{{APIRef("HTML Drag and Drop API")}}

The read-only DataTransferItem.kind property returns the kind–a string or a file–of the {{domxref("DataTransferItem")}} object representing the drag data item.

Value

A string representing the drag data item's kind. It must be one of the following values:

  • 'file'
    • : If the drag data item is a file.
  • 'string'
    • : If the kind of drag data item is a plain Unicode string.

Examples

This example shows the use of the kind property.

js
function dropHandler(ev) {
  console.log("Drop");
  ev.preventDefault();
  for (const item of ev.dataTransfer.items) {
    if (item.kind === "string" && item.type.match("^text/plain")) {
      // This item is the target node
      item.getAsString((s) => {
        ev.target.appendChild(document.getElementById(s));
      });
    } else if (item.kind === "string" && item.type.match("^text/html")) {
      // Drag data item is HTML
      console.log("… Drop: HTML");
    } else if (item.kind === "file" && item.type.match("^image/")) {
      // Drag data item is an image file
      const f = item.getAsFile();
      console.log("… Drop: File");
    }
  }
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also