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()

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

DataTransferItem.getAsString()

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

DataTransferItem.webkitGetAsEntry()

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

例

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

仕様書

Specification
HTML Standard
# the-datatransferitem-interface

ブラウザーの互換性

BCD tables only load in the browser