HTMLInputElement: webkitEntries-Eigenschaft

Die schreibgeschützte webkitEntries Eigenschaft der HTMLInputElement-Schnittstelle enthält ein Array von Dateisystemeinträgen (als Objekte basierend auf FileSystemEntry), welche die vom Benutzer ausgewählten Dateien und/oder Verzeichnisse darstellen, wenn ein <input>-Element vom Typ file verwendet wird, wobei die Auswahl durch Drag-and-Drop erfolgt ist: die Auswahl einer Datei im Dialogfeld lässt die Eigenschaft leer.

Das Array kann nur Verzeichnisse enthalten, wenn die webkitdirectory-Eigenschaft auf true gesetzt ist. Das bedeutet, dass das <input>-Element so konfiguriert wurde, dass der Benutzer Verzeichnisse auswählen kann.

Hinweis: Diese Eigenschaft heißt webkitEntries in der Spezifikation aufgrund ihrer Herkunft als Google Chrome-spezifische API. Es ist wahrscheinlich, dass sie eines Tages umbenannt wird.

Wert

Ein Array von Objekten basierend auf FileSystemEntry, wobei jedes Objekt eine Datei repräsentiert, die im <input>-Element ausgewählt wurde. Genauer gesagt, werden Dateien durch FileSystemFileEntry-Objekte dargestellt, und, wenn erlaubt, Verzeichnisse durch FileSystemDirectoryEntry-Objekte.

Beispiele

Dieses Beispiel zeigt, wie man ein Dateiauswahl-<input>-Element erstellt und die ausgewählten Dateien verarbeitet.

HTML

html
<input id="files" type="file" multiple />

JavaScript

js
document.getElementById("files").addEventListener("change", (event) => {
  event.target.webkitEntries.forEach((entry) => {
    /* do stuff with the entry */
  });
});

Jedes Mal, wenn ein change-Ereignis auftritt, durchläuft dieser Code die ausgewählten Dateien, erhält ihre auf FileSystemEntry basierenden Objekte und verarbeitet sie.

Spezifikationen

Specification
File and Directory Entries API
# dom-htmlinputelement-webkitentries

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch