DataTransfer: files-Eigenschaft

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 files schreibgeschützte Eigenschaft von DataTransfer-Objekten ist eine Liste der Dateien in der Drag-Operation. Wenn die Operation keine Dateien umfasst, ist die Liste leer.

Diese Funktion kann verwendet werden, um Dateien vom Desktop eines Benutzers in den Browser zu ziehen.

Hinweis: Die files-Eigenschaft von DataTransfer-Objekten kann nur innerhalb der drop- und paste-Ereignisse zugegriffen werden. Bei allen anderen Ereignissen wird die files-Eigenschaft leer sein, da ihr zugrunde liegender Datenspeicher sich in einem geschützten Modus befindet.

Wert

Eine Liste der Dateien in einer Drag-Operation, wobei jeder Listeneintrag einer Datei in der Operation entspricht. Wenn die Drag-Operation keine Dateien enthielt, ist die Liste leer.

Beispiele

Es gibt zwei Live-Beispiele für diese Schnittstelle:

Spezifikationen

Specification
HTML
# dom-datatransfer-files-dev

Browser-Kompatibilität