ドラッグが発生すると、ドラッグ対象 (dragstart
イベントが発生した要素) から半透明の画像が生成され、ドラッグ中にマウスポインタに沿って移動します。この画像は自動的に作成されるので、自分で作成する必要はありません。ただし、カスタム画像が必要な場合は、DataTransfer.setDragImage()
メソッドを使用して、使用するカスタム画像を設定することができます。画像は通常、<image>
要素になりますが、<canvas>
やその他の可視要素であっても構いません。
メソッドの x
座標と y
座標は、マウスポインタに対する画像の相対的な表示方法を定義します。これらの座標は、マウスカーソルがあるべき画像のオフセットを定義します。例えば、ポインタが中心に来るように画像を表示するには、画像の幅と高さの半分の値を使用します。
このメソッドは dragstart
イベントハンドラ内で呼び出す必要があります。
シンタックス
void dataTransfer.setDragImage(img | element, xOffset, yOffset);
引数
戻り値
- void
例
この例では、setDragImage()
メソッドの使用方法を示します。この例では example.gif
という名前の画像ファイルを参照していることに注意しましょう。そのファイルが存在する場合はそのファイルがドラッグ画像として使用され、そのファイルが存在しない場合はブラウザがデフォルトのドラッグ画像を使用します。
<!DOCTYPE html>
<html lang=ja>
<title>DataTransfer.setDragImage() の例</title>
<meta name="viewport" content="width=device-width">
<style>
div {
margin: 0em;
padding: 2em;
}
#source {
color: blue;
border: 1px solid black;
}
#target {
border: 1px solid black;
}
</style>
<script>
function dragstart_handler(ev) {
console.log("dragStart");
// ドラッグのフォーマットとデータを設定します。データにはイベントターゲットの ID を使用します。
ev.dataTransfer.setData("text/plain", ev.target.id);
// 画像を作成してドラッグ画像に使用する
// 注意: "example.gif" を既存の画像に変更しないと画像が作成されず、
// デフォルトのドラッグ画像が使用されます。
var img = new Image();
img.src = 'example.gif';
ev.dataTransfer.setDragImage(img, 10, 10);
}
function dragover_handler(ev) {
console.log("dragOver");
ev.preventDefault();
}
function drop_handler(ev) {
console.log("Drop");
ev.preventDefault();
// ドロップ対象のIDであるデータを取得します。
var data = ev.dataTransfer.getData("text");
ev.target.appendChild(document.getElementById(data));
}
</script>
<body>
<h1><code>DataTransfer.setDragImage()</code> の例</h1>
<div>
<p id="source" ondragstart="dragstart_handler(event);" draggable="true">
この要素を選択し、ドロップゾーンにドラッグしてから選択を解除して要素を移動します。</p>
</div>
<div id="target" ondrop="drop_handler(event);" ondragover="dragover_handler(event);">ドロップゾーン</div>
</body>
</html>
仕様
仕様書 | ステータス | コメント |
---|---|---|
HTML Living Standard setDragImage() の定義 |
現行の標準 | |
HTML 5.1 setDragImage() の定義 |
勧告 | W3C HTML5 に含まれない 勧告。 |
ブラウザの互換性
BCD tables only load in the browser
あわせて参照
{{page("/ja/docs/Web/API/DataTransfer", "あわせて参照")}}