DataTransferItem

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.

* Some parts of this feature may have varying levels of support.

DataTransferItem オブジェクトは、1 つのドラッグデータ項目を表します。ドラッグ操作中、それぞれの ドラッグイベントdataTransfer プロパティを持ち、このプロパティにはドラッグデータ項目の list を含みます。リスト内のそれぞれの項目は DataTransferItem オブジェクトです。

このインターフェイスにはコンストラクターがありません。

インスタンスプロパティ

DataTransferItem.kind 読取専用

ドラッグデータの項目の種類で、string(文字列)か file(ファイル)のどちらかです。

DataTransferItem.type 読取専用

ドラッグデータ項目の型、通常は MIME タイプです。

インスタンスメソッド

DataTransferItem.getAsFile()

ドラッグデータ項目に関連付けられた File オブジェクト (ドラッグ項目がファイルでない場合は null) を返します。

DataTransferItem.getAsFileSystemHandle() Experimental

ドラッグ中の項目がファイルであれば FileSystemFileHandle を、ドラッグ中の項目がディレクトリーであれば FileSystemDirectoryHandle を返します。

DataTransferItem.getAsString()

ドラッグデータ項目の文字列を引数に、指定されたコールバックを呼び出します。

DataTransferItem.webkitGetAsEntry()

選択したファイルのファイルシステム内の項目を表す FileSystemEntry に基づくオブジェクトを返します。これは通常、FileSystemFileEntry または FileSystemDirectoryEntry オブジェクトのいずれかになります。

このインターフェイスのすべてのメソッドとプロパティには、自身のリファレンスページがあり、それぞれのリファレンスページに例があります。

仕様書

Specification
HTML
# the-datatransferitem-interface

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
DataTransferItem
getAsFile
getAsFileSystemHandle
Experimental
getAsString
kind
type
webkitGetAsEntry

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.