DataTransferItem

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.

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

DasDataTransferItem-Objekt repräsentiert ein Drag-Daten-Element. Während einerDrag-Operation hat jedesDragEvent einedataTransfer-Eigenschaft, die einelist von Drag-Daten-Elementen enthält. Jedes Element in der Liste ist einDataTransferItem-Objekt.

DataTransferItem wurde ursprünglich für dieHTML 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 BeispielClipboardEvent.clipboardData undInputEvent.dataTransfer. Die Dokumentation vonDataTransferItem wird sich hauptsächlich auf die Nutzung in Drag-and-Drop-Operationen konzentrieren. Für die Nutzung vonDataTransferItem in diesen anderen Kontexten sollten Sie die Dokumentation der jeweiligen APIs konsultieren.

Dieses Interface hat keinen Konstruktor.

Instanz-Eigenschaften

DataTransferItem.kindSchreibgeschützt: DerTyp des Drag-Daten-Elements, entwederstring oderfile.
DataTransferItem.typeSchreibgeschützt: Der Typ des Drag-Daten-Elements, typischerweise ein MIME-Typ.

Instanz-Methoden

DataTransferItem.getAsFile(): Gibt dasFile-Objekt zurück, das mit dem Drag-Daten-Element verknüpft ist (oder null, wenn das Drag-Element keine Datei ist).
DataTransferItem.getAsFileSystemHandle()Experimentell: Gibt ein Promise zurück, das mit einemFileSystemFileHandle erfüllt wird, wenn das gezogene Element eine Datei ist, oder mit einemFileSystemDirectoryHandle 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 aufFileSystemEntry basiert und den Eintrag der ausgewählten Datei im Dateisystem repräsentiert. Dies ist im Allgemeinen entweder einFileSystemFileEntry oder einFileSystemDirectoryEntry-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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden