DataTransferItem: getAsString()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since November 2016.

Die DataTransferItem.getAsString()-Methode ruft die gegebene Rückruffunktion mit den Zeichenfolgendaten des Drag-Data-Items als Argument auf, wenn der kind des Elements ein einfacher Unicode-String ist (d.h. kind ist string).

Syntax

js
getAsString(callbackFn)

Parameter

callbackFn

Eine Rückruffunktion, die die folgenden Argumente erhält:

data

Die Stringdaten des DataTransferItem.

Rückgabewert

Keiner (undefined).

Beispiele

Dieses Beispiel zeigt die Verwendung der getAsString()-Methode als Inline-Funktion in einem drop-Ereignishandler.

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 === "string" && item.type.match("^text/uri-list")) {
      // Drag data item is URI
      console.log("… Drop: URI");
    } else if (item.kind === "file" && item.type.match("^image/")) {
      // Drag data item is an image file
      const f = item.getAsFile();
      console.log("… Drop: File");
    }
  }
}

Spezifikationen

Specification
HTML
# dom-datatransferitem-getasstring-dev

Browser-Kompatibilität

Siehe auch