このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 ⁨2015年7月⁩.

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

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

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

返値

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

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

仕様書

Specification
HTML
# dom-datatransfer-files-dev

ブラウザーの互換性