ondragleave イベント

DOM イベント DragEvent

定義と使用法

ドラッグ可能な要素やテキスト選択が有効な配置ターゲットから離れたときに、ondragleave イベントが発生します。

ondragenter と ondragleave イベントは、ユーザーが可拖動要素が配置ターゲットに近づくか、それから離れることを理解するのに役立ちます。例えば、可拖動要素が配置ターゲットに近づいたときに背景色を設定し、要素がターゲットから離れたときに色を解除することができます。

HTML5 ドラッグ＆ドロップドラッグ＆ドロップは HTML5 で非常に一般的な機能です。これは、オブジェクトを「捕まえて」異なる場所にドラッグする際に発生します。さらに詳しく知りたい場合は、以下の情報を読んでください。

注：要素をドラッグ可能にするには、以下の HTML 教程を使用してください。 HTML5 draggable 属性。

ヒント：デフォルトでは、リンクや画像はドラッグ可能であり、draggable 属性は必要ありません。

ドラッグ＆ドロップ操作の異なる段階で、多くのイベントが使用され、発生する可能性があります：

ドラッグ可能なターゲット（ソース要素）上でトリガーされるイベント：

  • ondragstart - ユーザーが要素をドラッグ開始したときに発生します
  • ondrag - 要素がドラッグされたときに発生します
  • ondragend - ユーザーがドラッグ要素を完了したときに発生します

配置ターゲット上でトリガーされるイベント：

  • ondragenter - ドラッグ可能な要素が配置ターゲットに入ったときに発生します
  • ondragover - ドラッグ可能な要素が配置ターゲット上にあるときに発生します
  • ondragleave - ドラッグ可能な要素が配置ターゲットから離れたときに発生します
  • ondrop - ドラッグ可能な要素が配置ターゲットに置かれたときに発生します

实例

ドラッグ可能な要素が配置ターゲットから移動したときに JavaScriptを実行します：

<div ondragleave="myFunction(event)"></div>

自分で試してみる

ページの下部に TIY 実例が多くあります。

文法

HTML で：

<element ondragleave="myScript">

自分で試してみる

JavaScript で：

object.ondragleave = function(){myScript};

自分で試してみる

JavaScript で addEventListener() メソッドを使用する：

object.addEventListener("dragleave", myScript);

自分で試してみる

注：Internet Explorer 8 またはそれ以前のバージョンはサポートしていません addEventListener() メソッド。

技术细节

冒泡： 支持
可取消： 不支持
事件类型： DragEvent
支持的 HTML 标签： 所有 HTML 元素
DOM 版本： Level 3 Events

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

事件 Chrome IE Firefox Safari Opera
ondragleave 4.0 9.0 3.5 6.0 12.0

实例

对所有可能的拖放事件的演示：

<p draggable="true" id="dragtarget">Drag me!</p>
<div class="droptarget">Drop here!</div>
<script>
/* ----------------- 在拖动目标上触发的事件 ----------------- */
document.addEventListener("dragstart", function(event) {
  // dataTransfer.setData()方法设置被拖拽数据的数据类型和值
  event.dataTransfer.setData("Text", event.target.id);
  // 开始拖动 p 元素时输出一些文本
  document.getElementById("demo").innerHTML = "Started to drag the p element.";
  // 更改可拖动元素的不透明度
  event.target.style.opacity = "0.4";
});
// 拖动 p 元素时，更改输出文本的颜色
document.addEventListener("drag", function(event) {
  document.getElementById("demo").style.color = "red";
});
// 完成拖动 p 元素后输出一些文本并重置不透明度
document.addEventListener("dragend", function(event) {
  document.getElementById("demo").innerHTML = "Finished dragging the p element.";
  event.target.style.opacity = "1";
});
/* ----------------- ドロップ先上でトリガーされるイベント ----------------- */
// ドラッグ可能な p 要素が droptarget に入ったとき、DIV の枠線スタイルを変更します
document.addEventListener("dragenter", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "3px dotted red";
  }
});
// デフォルトでは、データや要素を他の要素に配置することはできません。配置を許可するには、要素のデフォルト処理を阻止する必要があります
document.addEventListener("dragover", function(event) {
  event.preventDefault();
});
// ドラッグ可能な p 要素が droptarget を離れたとき、DIV の枠線スタイルをリセットします
document.addEventListener("dragleave", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "";
  }
});
/* ドロップ時 - ブラウザのデータのデフォルト処理を防ぎます（デフォルトのドロップ時はリンクで開く）
出力テキストの色と DIV の枠線色をリセットします
dataTransfer.getData() メソッドを使用してドラッグデータを取得します
ドラッグされたデータはドラッグされた要素の ID （"drag1"）です
ドラッグされた要素をドロップ先の要素に追加します
*/
document.addEventListener("drop", function(event) {
  event.preventDefault();
  if ( event.target.className == "droptarget" ) {
    document.getElementById("demo").style.color = "";
    event.target.style.border = "";
    var data = event.dataTransfer.getData("Text");
    event.target.appendChild(document.getElementById(data));
  }
});
</script>

自分で試してみる

関連ページ

HTML チュートリアル：HTML5 ドラッグ＆ドロップ

HTML リファレンスマニュアル：HTML draggable 属性

DOM イベント DragEvent