HTML DOM FileUploadオブジェクト
FileUpload オブジェクト
HTML 文書で <input type="file"> タグが出現するたびに、FileUpload オブジェクトが作成されます。
この要素には、ファイル名を入力するためのテキスト入力フィールドと、ファイルをグラフィカルに選択するためのファイル選択ダイアログを開くボタンが含まれています。
この要素の value プロパティにはユーザーが指定したファイル名が保存されますが、file-upload 要素を含むフォームが送信されると、ブラウザーはファイル名だけでなく選択されたファイルの内容もサーバーに送信します。
安全上の理由から、file-upload 要素では HTML 作成者や JavaScript プログラマーがデフォルトのファイル名を指定することはできません。HTML の value 属性は無視され、この種の要素では value プロパティは読み取り専用です。つまり、ユーザーだけがファイル名を入力できます。ユーザーがファイル名を選択または編集すると、file-upload 要素は onchange イベントハンドラーをトリガーします。
FileUpload オブジェクトには、フォームの elements[] 配列を反復処理するか、document.getElementById() を使用してアクセスできます。
FileUpload オブジェクトのプロパティ
W3C:W3C 標準。
| プロパティ | 説明 | W3C |
|---|---|---|
| disabled | FileUpload オブジェクトが無効かどうかを設定または返します。 | Yes |
| accept | ファイル転送を示す MIME タイプのリスト（カンマ区切り）を設定または返します。 | Yes |
| form | FileUpload オブジェクトを含むフォームへの参照を返します。 | Yes |
| name | FileUpload オブジェクトの名前を設定または返します。 | Yes |
| type | フォーム要素のタイプを返します。FileUpload の場合は "file" です。 | Yes |
| value | ユーザーが入力したテキストによって設定された FileUpload オブジェクトのファイル名を返します。 | Yes |