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 July 2015.
Die DataTransferItem.getAsString()
-Methode ruft die gegebene Rückruffunktion mit den Zeichenfolgendaten des Drag-Datenobjekts als Argument auf, wenn das kind
des Elements eine einfache Unicode-Zeichenfolge ist (d.h. kind
ist string
).
Syntax
getAsString(callbackFn)
Parameter
callbackFn
-
Eine Rückruffunktion, die folgende Argumente erhält:
data
-
Die Zeichenfolgendaten des
DataTransferItem
.
Rückgabewert
Keiner (undefined
).
Beispiele
Dieses Beispiel zeigt die Verwendung der getAsString()
-Methode als Inline-Funktion in einem drop
-Ereignishandler.
function dropHandler(ev) {
console.log("Drop");
ev.preventDefault();
const data = ev.dataTransfer.items;
for (let 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((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
const f = data[i].getAsFile();
console.log("… Drop: File");
}
}
}
Spezifikationen
Specification |
---|
HTML # dom-datatransferitem-getasstring-dev |