HTMLInputElement: свойство files
Базовая Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Свойство HTMLInputElement.files позволяет получить доступ к FileList, выбранным с помощью элемента <input type="file">.
Значение
Объект FileList, содержащий список выбранных файлов, или null, если элемент HTMLInputElement не соответствует типу type="file".
Примеры
В примере ниже показано, как получить доступ к свойству HTMLInputElement.files и вывести имя, дату изменения, размер и тип каждого выбранного пользователем файла.
HTML
<input id="files" type="file" multiple />
JavaScript
Обратите внимание, что HTMLInputElement.files по-прежнему возвращает экземпляр FileList, даже если файлы не выбраны. Поэтому можно безопасно перебирать его с помощью for...of без проверки наличия выбранных файлов.
const fileInput = document.getElementById("files");
console.log(fileInput.files instanceof FileList); // true even if empty
for (const file of fileInput.files) {
console.log(file.name); // prints file name
let fileDate = new Date(file.lastModified);
console.log(fileDate.toLocaleDateString()); // prints legible date
console.log(
file.size < 1000 ? file.size : Math.round(file.size / 1000) + "KB",
);
console.log(file.type); // prints MIME type
}
Спецификации
| Спецификация |
|---|
| HTML # dom-input-files-dev |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
files |
2 | 12 | 3 | ≤12.1 | 4 | 18 | 4 | ≤12.1 | 3 | 1.0 | ≤37 |
См. также
© 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/files