HTMLInputElement: webkitEntries-Eigenschaft

Die schreibgeschützte webkitEntries-Eigenschaft der HTMLInputElement-Schnittstelle enthält ein Array von Dateisystemeinträgen (als Objekte basierend auf FileSystemEntry), die Dateien und/oder Verzeichnisse darstellen, die vom Benutzer mit einem <input>-Element vom Typ file ausgewählt wurden, allerdings nur, wenn diese Auswahl per Drag-and-Drop erfolgt ist: Die Auswahl einer Datei im Dialogfenster lässt die Eigenschaft leer.

Das Array kann nur Verzeichnisse enthalten, wenn die webkitdirectory-Eigenschaft true ist. Dies bedeutet, dass das <input>-Element so konfiguriert wurde, dass es dem Benutzer erlaubt, Verzeichnisse auszuwählen.

Hinweis: Diese Eigenschaft wird in der Spezifikation webkitEntries genannt aufgrund ihrer Ursprünge als API spezifisch für Google Chrome. Es ist wahrscheinlich, dass sie eines Tages umbenannt wird.

Wert

Ein Array von Objekten basierend auf FileSystemEntry, von denen jedes eine Datei darstellt, 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 Datei-Auswahl-<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 eintritt, iteriert dieser Code über die ausgewählten Dateien, erhält ihre FileSystemEntry-basierten Objekte und agiert auf diese.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch