From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/datatransfer/index.html | 151 +++++++++++++++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 files/ja/web/api/datatransfer/index.html (limited to 'files/ja/web/api/datatransfer/index.html') diff --git a/files/ja/web/api/datatransfer/index.html b/files/ja/web/api/datatransfer/index.html new file mode 100644 index 0000000000..1430b904fe --- /dev/null +++ b/files/ja/web/api/datatransfer/index.html @@ -0,0 +1,151 @@ +--- +title: DataTransfer +slug: Web/API/DataTransfer +tags: + - API + - DataTransfer + - HTML Drag and Drop API + - Interface + - NeedsMarkupWork + - Reference + - Web Development + - drag and drop +translation_of: Web/API/DataTransfer +--- +
{{APIRef("HTML Drag and Drop API")}}
+ +

DataTransfer オブジェクトは、ドラッグ＆ドロップ操作中にドラッグされているデータを保持するために使用されます。これは、1 つ以上のデータ項目を保持することができ、それぞれが 1 つ以上のデータ型を持ちます。ドラッグ＆ドロップの詳細については、HTML ドラッグ＆ドロップ API を参照してください。

+ +

このオブジェクトはすべての {{domxref("DragEvent","ドラッグイベント")}} の {{domxref("DragEvent.dataTransfer","dataTransfer")}} プロパティからアクセスすることができます。

+ +

コンストラクタ

+ +
+
{{domxref("DataTransfer.DataTransfer","DataTransfer()")}}
+
新規 DataTransfer オブジェクトを作成して返す。
+
+ +

プロパティ一覧

+ +

標準プロパティ

+ +
+
{{domxref("DataTransfer.dropEffect")}}
+
現在選択されているドラッグ&ドロップ操作の種類を取得したり、新しい操作の種類をセットしたりします。値は none, copy, link, move のいずれかです。
+
{{domxref("DataTransfer.effectAllowed")}}
+
とりうるすべての操作の種類を与えます。none, copy, copyLink, copyMove, link, linkMove, move, all, uninitialized のいずれかです。
+
+ +
+
{{domxref("DataTransfer.files")}}
+
データトランスファーが保持していて利用可能なすべてのローカルファイルのリストを保持します。ドラッグ操作がファイルのドラッグによるものではない場合、このプロパティは空のリストになります。
+
{{domxref("DataTransfer.items")}} {{readonlyInline}}
+
 全てのドラッグデータのリストである {{domxref("DataTransferItemList")}} オブジェクトを返します。.
+
{{domxref("DataTransfer.types")}} {{readonlyInline}}
+
{{event("dragstart")}} イベントでセットされたフォーマットを示す{{domxref("DOMString","strings")}}の配列。
+
+ +

Gecko プロパティ

+ +

{{SeeCompatTable}}

+ +
注: この節の全プロパティは Gecko-固有のものです。
+ +
+
{{domxref("DataTransfer.mozCursor")}}
+
ドラッグカーソルの状態を返します。主にタブドラッグの際のカーソルを制御するのに使います。
+
{{domxref("DataTransfer.mozSourceNode")}} {{readonlyInline}}
+
ドラッグ操作を開始するためにボタンを押下したときにマウスカーソルのあった{{ domxref("Node") }}を返します。外部アプリケーションからのドラッグの場合や、ドラッグを開始したノードが呼び出し元からアクセスできない物であった場合は、値は null となります。
+
{{domxref("DataTransfer.mozUserCancelled")}} {{readonlyInline}}
+
このプロパティは dragend イベントに対してのみ適用され、ユーザーが Esc キーを押下してドラッグ操作を取り消した場合は値が true となります。不正な場所でドロップした場合など、その他の理由でドラッグ操作に失敗した場合には、値は false となります。
+
+ +

Deprecated プロパティ

+ +
+
{{domxref("DataTransfer.mozItemCount")}} {{readonlyInline}} {{deprecated_inline}}
+
ドラッグされている項目の個数を返します。Firefox 71 で削除されます。
+
+ +

メソッド

+ +

標準メソッド

+ +
+
{{domxref("DataTransfer.clearData()")}}
+
指定された型のデータを削除します。型の指定は省略可能です。型として空の文字列を指定した場合、もしくは型を指定しなかった場合、すべての型のデータが削除されます。指定された型のデータが存在しない場合、またはデータトランスファーが何もデータを持っていない場合、このメソッドは何もしません。
+
{{domxref("DataTransfer.getData()")}}
+
指定された型のデータを取得します。指定された型のデータが存在しない場合、またはデータトランスファーが何もデータを保持していない場合、空文字を返します。
+
{{domxref("DataTransfer.setData()")}}
+
指定された型のデータを設定します。その型のデータが存在しない場合、データはリストの最後に追加されるため、データ型のリストの最後の項目は、最後に追加された新しいデータ型となります。その型のデータがすでに存在している場合、データ型のリストにおける元と同じ位置で、古いデータが新しいデータと置き換わります。
+
{{domxref("DataTransfer.setDragImage()")}}
+
ドラッグ中に表示されるフィードバックイメージについて、独自のものを使用したい場合に、それをセットします。
+
+ +

Gecko メソッド

+ +

{{Non-standard_header()}}

+ +
注: この節の全メソッドは Gecko-固有のものです。
+ +
+
{{domxref("DataTransfer.addElement()")}}
+
ドラッグ元の要素を指定します。
+
+ +

Deprecated メソッド

+ +
+
{{domxref("DataTransfer.mozClearDataAt()")}} {{deprecated_inline}}
+
指定されたインデックスの項目について、指定された形式に関連付けられたデータを削除します。インデックスは 0〜(項目の数-1）の範囲です。Firefox 71 で削除されます。
+
{{domxref("DataTransfer.mozGetDataAt()")}} {{deprecated_inline}}
+
指定されたインデックスの項目の、指定された形式のデータを取得します。存在しない項目またはデータ形式を指定した場合は null を返します。インデックスは 0〜(項目の数-1）の範囲です。Firefox 71 で削除されます。
+
{{domxref("DataTransfer.mozSetDataAt()")}} {{deprecated_inline}}
+
データトランスファーは複数の項目を保持する事ができ、それぞれの項目には 0 から始まるインデックスが付けられます。mozSetDataAt() は、すでに存在する項目を変更する場合には mozItemCount より小さい値をインデックスとして指定し、新しい項目を追加する場合は mozItemCount に等しい値をインデックスとして指定します。また、mozItemCount は項目を追加する度に増加します。Firefox 71 で削除されます。
+
{{domxref("DataTransfer.mozTypesAt()")}} {{deprecated_inline}}
+
指定されたインデックスの項目が保持しているデータの形式のリスト（文字列の配列）を返します。0〜(項目の数-1）の範囲外のインデックスを指定した場合は、空のリストを返します。Firefox 71 で削除されます。
+
+ +

例

+ +

この文書に載っているすべてのメソッドとプロパティは自分自身のリファレンスページを持ち、そのページに直接例が載っているか、例へのリンクがあるかのいずれかです。

+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + +
仕様書策定状況コメント
{{SpecName('HTML WHATWG', 'interaction.html#datatransfer','DataTransfer')}}{{Spec2('HTML WHATWG')}}mozCursor, mozItemCount, mozSourceNode, mozUserCancelled, addElement(), mozClearDataAt(), mozGetDataAt(), mozSetDataAt() and mozTypesAt are Gecko specific.
{{SpecName('HTML5.1', 'editing.html#the-datatransfer-interface','DataTransfer')}}{{Spec2('HTML5.1')}}Not included in W3C HTML5 {{Spec2('HTML5 W3C')}}
+ +

ブラウザー実装状況

+ + + +

{{Compat("api.DataTransfer")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf