Spec-Zone.ru › Web APIs

HTMLInputElement: свойство webkitEntries

Только для чтения webkitEntries свойство интерфейса HTMLInputElement содержит массив элементов файловой системы (как объекты, основанные на FileSystemEntry), представляющие файлы и/или каталоги, выбранные пользователем с помощью элемента <input> типа file, но только если этот выбор был сделан с помощью перетаскивания: выбор файла в диалоговом окне оставит это свойство пустым.

Массив может содержать только каталоги, если свойство webkitdirectory равно true. Это означает, что элемент <input> был настроен таким образом, чтобы пользователь мог выбирать каталоги.

Примечание: Это свойство называется webkitEntries в спецификации из-за его происхождения как API, специфичного для Google Chrome. Возможно, в будущем оно будет переименовано.

Значение

Массив объектов, основанных на FileSystemEntry, каждый из которых представляет один файл, выбранный в элементе <input>. Более конкретно, файлы представлены объектами FileSystemFileEntry, а если разрешено, каталоги — объектами FileSystemDirectoryEntry.

Примеры

В этом примере показано, как создать элемент выбора файла <input> и обработать выбранные файлы.

HTML

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

JavaScript

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

Каждый раз, когда происходит событие change, этот код итерирует по выбранным файлам, получает их объекты, основанные на FileSystemEntry, и выполняет действия над ними.

Спецификации

Спецификация
API для файлов и каталогов
# dom-htmlinputelement-webkitentries

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
webkitEntries 22 79 50 15 11.1 25 Нет 14 11.3 1.5 Нет

См. также

  • API для файлов и каталогов
  • Введение в API для файлов и каталогов
  • HTMLInputElement
  • FileSystemEntry
  • FileSystem

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitEntries

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API