HTMLInputElement : propriété webkitEntries
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La propriété en lecture seule webkitEntries de l'interface HTMLInputElement contient un tableau d'entrées du système de fichiers (sous forme d'objets basés sur FileSystemEntry) représentant des fichiers et/ou des répertoires sélectionnés par l'utilisateur·ice à l'aide d'un élément <input> de type file, mais uniquement si cette sélection a été effectuée par glisser-déposer : la sélection d'un fichier dans la boîte de dialogue laissera la propriété vide.
Le tableau ne peut contenir que des répertoires si la propriété webkitdirectory est true. Cela signifie que l'élément <input> a été configuré pour permettre à l'utilisateur·ice de choisir des répertoires.
Note :
Cette propriété est appelée webkitEntries dans la spécification en raison de ses origines en tant qu'API spécifique à Google Chrome. Il est probable qu'elle soit renommée un jour.
Valeur
Un tableau d'objets basés sur FileSystemEntry, chacun représentant un fichier sélectionné dans l'élément <input>. Plus précisément, les fichiers sont représentés par des objets FileSystemFileEntry et, si elles sont autorisées, les répertoires sont représentés par des objets FileSystemDirectoryEntry.
Exemples
Cet exemple montre comment créer un élément <input> de sélection de fichiers et traiter les fichiers sélectionnés.
HTML
<input id="files" type="file" multiple />
JavaScript
document.getElementById("files").addEventListener("change", (event) => {
event.target.webkitEntries.forEach((entry) => {
/* faire quelque chose avec l'entrée */
});
});
Chaque fois qu'un évènement change se produit, ce code parcourt les fichiers sélectionnés, obtenant leurs objets basés sur FileSystemEntry et agissant sur eux.
Spécifications
| Spécification |
|---|
| File and Directory Entries API # dom-htmlinputelement-webkitentries |
Compatibilité des navigateurs
Voir aussi
- L'API d'entrée de fichiers et de répertoires
- L'interface
HTMLInputElement - L'interface
FileSystemEntry - L'interface
FileSystem