HTMLInputElement.files
HTMLInputElement.files
プロパティを通じて、<input type="file">
要素で選択された FileList
にアクセスできます。
値
FileList
のインスタンスが返ります。HTMLInputElement
が type="file"
でない場合は、null
が返ります。
例
以下の例は、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
for (const file of fileInput.files) {
console.log(file.name); // ファイル名を出力します
}
仕様書
Specification |
---|
HTML Standard # dom-input-files-dev |
ブラウザーの互換性
BCD tables only load in the browser