DataTransfer.files

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

filesDataTransfer オブジェクトのプロパティで、ドラッグ操作中のファイルのリストです。操作にファイルが含まれていない場合、リストは空になります。

この機能を利用して、ユーザーのデスクトップからブラウザーにファイルをドラッグすることができます。

メモ: DataTransfer オブジェクトの files プロパティは、 drop イベントの中からのみアクセスできます。それ以外のどのイベントでも、 files プロパティは空になります。その基礎となるデータストアが保護モードになるからです。

返値

ドラッグ操作中のファイルのリストで、 1 つのリスト項目が 1 つのファイルを表します。操作にファイルが含まれていない場合、リストは空になります。

このインターフェイスには 2 つのライブ例があります。

仕様書

Specification
HTML Standard
# dom-datatransfer-files-dev

ブラウザーの互換性

BCD tables only load in the browser