DataTransferItem

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.

Das DataTransferItem-Objekt repräsentiert ein Datenobjekt beim Ziehen. Während einer Zieh-Operation hat jedes DragEvent eine dataTransfer-Eigenschaft, die eine Liste von Datenobjekten beim Ziehen enthält. Jedes Element in der Liste ist ein DataTransferItem-Objekt.

DataTransferItem wurde ursprünglich für die HTML Drag and Drop API entwickelt und ist nach wie vor im HTML-Bereich des Ziehens-und-Ablegens spezifiziert, wird aber jetzt auch von anderen APIs verwendet, wie z.B. ClipboardEvent.clipboardData und InputEvent.dataTransfer. Die Dokumentation von DataTransferItem wird sich hauptsächlich auf seine Nutzung in Zieh-Operationen konzentrieren, und Sie sollten die Dokumentationen der anderen APIs für die Nutzung von DataTransferItem in diesen Kontexten konsultieren.

Dieses Interface hat keinen Konstruktor.

Instanz-Eigenschaften

DataTransferItem.kind Schreibgeschützt: Die Art des Datenobjekts beim Ziehen, string oder file.
DataTransferItem.type Schreibgeschützt: Der Typ des Datenobjekts beim Ziehen, typischerweise ein MIME-Typ.

Instanz-Methoden

DataTransferItem.getAsFile(): Gibt das File-Objekt zurück, das mit dem Datenobjekt beim Ziehen verknüpft ist (oder null, wenn das Zieh-Objekt keine Datei ist).
DataTransferItem.getAsFileSystemHandle() Experimentell: Gibt einen FileSystemFileHandle zurück, wenn das gezogene Objekt eine Datei ist, oder einen FileSystemDirectoryHandle, wenn das gezogene Objekt ein Verzeichnis ist.
DataTransferItem.getAsString(): Ruft den angegebenen Callback mit dem String des Datenobjekts beim Ziehen als Argument auf.
DataTransferItem.webkitGetAsEntry(): Gibt ein Objekt basierend auf FileSystemEntry zurück, das den Eintrag der ausgewählten Datei im Dateisystem repräsentiert. Dies ist im Allgemeinen entweder ein FileSystemFileEntry oder FileSystemDirectoryEntry-Objekt.

Beispiel

Alle Methoden und Eigenschaften dieses Interfaces haben ihre eigene Referenzseite, und jede Referenzseite enthält ein Beispiel für deren Nutzung.

Spezifikationen

Specification
HTML Standard # the-datatransferitem-interface

Browser-Kompatibilität

BCD tables only load in the browser