SYNCERのロゴ
アイキャッチ画像

DataTransferItemList - 転送データの一覧

DataTransferItemListは、転送中のデータの一覧を管理するための機能を備えたインターフェイスです。

概要

名前
DataTransferItemList
IDL
[Exposed=Window]
interface DataTransferItemList {
  readonly attribute unsigned long length;
  getter DataTransferItem (unsigned long index);
  DataTransferItem? add(DOMString data, DOMString type);
  DataTransferItem? add(File data);
  void remove(unsigned long index);
  void clear();
};
仕様書
https://html.spec.whatwg.org/multipage/dnd.html#datatransferitemlist

チュートリアル

DataTransferItemListは、DataTransfer.itemsが返します。

var callbackFn = function ( event ) {
	console.log( event.dataTransfer.items ) ;	// DataTransferItemList
}

element.ondragstart = callbackFn ;

ブラケット記法で、インデックス番号のデータ(DataTransferItem)を取得できます。

var dataTransferItemList = event.dataTransfer.items ;

dataTransferItemList[0] ;	// 1つ目のデータ
dataTransferItemList[1] ;	// 2つ目のデータ
dataTransferItemList[2] ;	// 3つ目のデータ

プロパティ

length

転送データの個数を返します。

メソッド

add()

転送するデータを1つ追加します。

clear()

転送するデータを全て削除します。

remove()

転送するデータを1つ削除します。

定数

固有の定数はありません。

イベント

固有のイベントハンドラはありません。

サポート状況

クリックすると、バージョンごとの対応状況を確認できます。

FeaturesChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
DataTransferItemList 50+×× 12+× 4.4+
add() 50+×× 12+× 4.4+
clear() 50+×× 12+× 4.4+
length 50+×× 12+× 4.4+
remove() 31+ 50+×× 18+××
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月11日 (水)
コンテンツを公開しました。