DataTransfer.setData()
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.
DataTransfer.setData()
メソッドは、ドラッグ操作の drag data
に指定したデータと型を設定します。与えられた型のデータが存在しない場合、このデータはドラッグデータストアの末尾に加えられ、このような types
リストの最後の項目は新しい型になります。与えられた型のデータが存在する場合、既存のデータが同じ位置で置き換えられます。同じ型のデータが置き換えられる時、types
リストの並び順は変更されません。
データ型は、例えば text/plain
や text/uri-list
です。
構文
setData(format, data);
引数
format
-
文字列で、ドラッグオブジェクトに追加するドラッグデータの型を表します。
data
-
文字列で、ドラッグオブジェクトに追加するデータを表します。
返値
なし (undefined
)。
例
この例は、DataTransfer
オブジェクトの getData()
メソッドおよび setData()
メソッド、clearData()
メソッドの使い方を紹介します。
Examples of DataTransfer's setData(), getData() and clearData()
Examples of DataTransfer
: setData()
, getData()
, clearData()
Select this element, drag it to the Drop Zone and then release the selection to move the element.
Drop Zone
仕様書
Specification |
---|
HTML # dom-datatransfer-setdata-dev |