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.

* Some parts of this feature may have varying levels of support.

Das DataTransferItem-Objekt repräsentiert ein Drag-Daten-Element. Während einer Drag-Operation hat jedes DragEvent eine dataTransfer-Eigenschaft, die eine list von Drag-Daten-Elementen enthält. Jedes Element in der Liste ist ein DataTransferItem-Objekt.

DataTransferItem wurde ursprünglich für die HTML Drag and Drop API konzipiert und wird immer noch im HTML-Drag-and-Drop-Abschnitt spezifiziert. Es wird jetzt jedoch auch von anderen APIs verwendet, wie zum Beispiel ClipboardEvent.clipboardData und InputEvent.dataTransfer. Die Dokumentation von DataTransferItem wird sich hauptsächlich auf die Nutzung in Drag-and-Drop-Operationen konzentrieren. Für die Nutzung von DataTransferItem in diesen anderen Kontexten sollten Sie die Dokumentation der jeweiligen APIs konsultieren.

Dieses Interface hat keinen Konstruktor.

Instanz-Eigenschaften

DataTransferItem.kind Schreibgeschützt

Der Typ des Drag-Daten-Elements, entweder string oder file.

DataTransferItem.type Schreibgeschützt

Der Typ des Drag-Daten-Elements, typischerweise ein MIME-Typ.

Instanz-Methoden

DataTransferItem.getAsFile()

Gibt das File-Objekt zurück, das mit dem Drag-Daten-Element verknüpft ist (oder null, wenn das Drag-Element keine Datei ist).

DataTransferItem.getAsFileSystemHandle()

Gibt ein Promise zurück, das mit einem FileSystemFileHandle erfüllt wird, wenn das gezogene Element eine Datei ist, oder mit einem FileSystemDirectoryHandle erfüllt wird, wenn das gezogene Element ein Verzeichnis ist.

DataTransferItem.getAsString()

Ruft den angegebenen Callback mit dem String des Drag-Daten-Elements als Argument auf.

DataTransferItem.webkitGetAsEntry()

Gibt ein Objekt zurück, das auf FileSystemEntry basiert und den Eintrag der ausgewählten Datei im Dateisystem repräsentiert. Dies ist im Allgemeinen entweder ein FileSystemFileEntry oder ein 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
# the-datatransferitem-interface

Browser-Kompatibilität