nsIDOMFileList

出典: MDC

nsIDOMFileList インタフェースには、ユーザが Web フォーム上の「file」入力フィールドで選択したファイルを説明した nsIDOMFile オブジェクトのリストが含まれています。

すべての <INPUT> 要素ノードは、このリスト内の項目へのアクセスを許可する fileList 配列を持っています。例えば、HTML に以下のファイル入力フィールドが含まれていた場合、

<input id="fileItem" type=file>

以下のようなコードで、このノードのファイルリストの最初のファイルを、様々な形式で取得できます。

// UTF-8 (既定の文字エンコーディング) でファイルのデータを取得します
document.getElementById('fileItem').fileList[0].getAsText("");

// 具体的に UTF-8 として解釈されたファイルのデータを取得します
document.getElementById('fileItem').fileList[0].getAsText("utf8")

// data: URL としてファイルのデータを取得します
document.getElementById('fileItem').fileList[0].getAsDataURL()

// 生のバイナリデータとしてファイルのデータを取得します
document.getElementById('fileItem').fileList[0].getAsBinary()

目次 1 メソッドの概要 2 属性 3 属性 3.1 item() 3.1.1 引数 3.1.2 戻り値 4 関連記事

nsIDOMFileList は content/base/public/nsIDOMFileList.idl で定義されています。これは scriptable で 非凍結です。 (Mozilla 1.9から更新されていません)

継承元: nsISupports

[編集] メソッドの概要

nsIDOMFile item(in unsigned long index);

[編集] 属性

属性	型	説明
length	unsigned long	リスト内のファイル数を示す読み取り専用の属性。

[編集] 属性

[編集] item()

ファイルリスト内の指定されたインデックスにある nsIDOMFile を返します。

 nsIDOMFile item(
   in unsigned long index
 );

[編集] 引数

index

リストから取得するファイルの、ゼロベースのインデックス。

[編集] 戻り値

リクエストされたファイルを表す nsIDOMFile。

[編集] 関連記事

nsIDOMFile, nsIDOMFileException