FileList - ファイルの一覧

2017/10/04

FileListは、ファイルの一覧を表すオブジェクトです。file typeのinput要素などから取得できます。

概要

名前

FileList

IDL

[Exposed=(Window,Worker), Serializable]
interface FileList {
  getter File? item(unsigned long index);
  readonly attribute unsigned long length;
};

仕様書

https://w3c.github.io/FileAPI/#dfn-filelist

チュートリアル

FileListは、input要素(HTMLInputElement.files)から取得できます。

<input type="file" multiple id="hoge">

var element = document.getElementById( "hoge" ) ;

element.onchange = function () {
	console.log( element.files ) ;
}

下記はデモです。適当に、ファイルを選択状態にしてみて下さい。選択したファイルが当サーバーに送信されることはないのでご安心下さい。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<head>
<style>
	div#result { white-space: pre-wrap ; }
	input { width: 95% ; font-size: 16px ; }
</style>
</head>
<body>
	<input type="file" multiple id="hoge">
<hr>
	<div id="result"></div>
<script>
var element = document.getElementById( "hoge" ) ;
var resultElement = document.getElementById( "result" ) ;

element.onchange = function () {
	console.log( element.files ) ;
	resultElement.appendChild( new Text( element.files.length + "個のファイルを選択しました!!" ) ) ;
}
</script>
</body>
</html>