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
<input id="files" type="file" multiple />
JavaScript
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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
webkitEntries |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support