ondragleave 事件

事件对象参考手册 事件对象

在可拖动的元素移出放置目标时执行 JavaScript :

<!DOCTYPE HTML>
<html>
<head>
  <meta charset="utf-8">
  <title>蜜蜂教程(mifengjc.com)</title>
  <style>
    .droptarget {
      float: left;
      width: 100px;
      height: 35px;
      margin: 15px;
      margin-right: 100px;
      padding: 10px;
      border: 1px solid #aaaaaa;
    }
  </style>
</head>
<body>

  <p>在两个矩形框中来回拖动 p 元素:</p>
  <div class="droptarget" ondrop="drop(event)" ondragenter="dragEnter(event)" ondragleave="dragLeave(event)" ondragover="allowDrop(event)">
    <p ondragstart="dragStart(event)" draggable="true" id="dragtarget">拖动我!</p>
  </div>
  <div class="droptarget" ondragenter="dragEnter(event)" ondragleave="dragLeave(event)" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
  <p style="clear:both;"><strong>注意：</strong>Internet Explorer 8 及更早 IE 版本或 Safari 5.1 及更早版本的浏览器不支持 drag 事件。</p>
  <p id="demo"></p>
  <script>
    function dragStart(event) {
      event.dataTransfer.setData("Text", event.target.id);
    }

    function dragEnter(event) {
      document.getElementById("demo").innerHTML = "进入放置区域";
      if (event.target.className == "droptarget") {
        event.target.style.border = "3px dotted red";
      }
    }

    function dragLeave(event) {
      document.getElementById("demo").innerHTML = "离开放置区域";
      if (event.target.className == "droptarget") {
        event.target.style.border = "";
      }
    }

    function allowDrop(event) {
      event.preventDefault();
    }

    function drop(event) {
      event.preventDefault();
      var data = event.dataTransfer.getData("Text");
      event.target.appendChild(document.getElementById(data));
    }
  </script>

</body>
</html>

尝试一下 »

本文底部包含了更多实例。

定义和用法

ondragleave 事件在可拖动的元素或选取的文本移出放置目标时执触发。

ondragenter 和 ondragleave 事件可以帮助用户更好的理解可拖动元素进入和离开放置区域的过程。 你可以在可拖动元素进入和离开放置区域时设置不同的背景颜色。

拖放是 HTML5 中非常常见的功能。 更多信息可以查看我们 HTML 教程中的 HTML5 拖放。

注意： 为了让元素可拖动，需要使用 HTML5 draggable 属性。

提示： 链接和图片默认是可拖动的，不需要 draggable 属性。

在拖放的过程中会触发以下事件：

  • 在拖动目标上触发事件 (源元素):
    • ondragstart - 用户开始拖动元素时触发
    • ondrag - 元素正在拖动时触发
    • ondragend - 用户完成元素拖动后触发

  • 释放目标时触发的事件:
    • ondragenter - 当被鼠标拖动的对象进入其容器范围内时触发此事件
    • ondragover - 当某被拖动的对象在另一对象容器范围内拖动时触发此事件
    • ondragleave - 当被鼠标拖动的对象离开其容器范围内时触发此事件
    • ondrop - 在一个拖动过程中，释放鼠标键时触发此事件

浏览器支持

表格中的数字表示支持该事件的第一个浏览器的版本号。

事件
ondragleave 4.0 9.0 3.5 6.0 12.0

语法

HTML 中：

<element ondragleave="myScript">
<!DOCTYPE HTML>
<html>
<head>
  <meta charset="utf-8">
  <title>蜜蜂教程(mifengjc.com)</title>
  <style>
    .droptarget {
      float: left;
      width: 100px;
      height: 35px;
      margin: 15px;
      margin-right: 100px;
      padding: 10px;
      border: 1px solid #aaaaaa;
    }
  </style>
</head>
<body>

  <p>该实例演示了如何向 p 元素添加 "ondragstart" 和 "ondrag" 事件及向 div 元素添加 "ondragover" 和 "ondrop" 事件。 </p>
  <p>在两个矩形框中来回拖动 p 元素:</p>
  <div class="droptarget" ondrop="drop(event)" ondragenter="dragEnter(event)" ondragleave="dragLeave(event)" ondragover="allowDrop(event)">
    <p ondragstart="dragStart(event)" draggable="true" id="dragtarget">拖动我!</p>
  </div>
  <div class="droptarget" ondragenter="dragEnter(event)" ondragleave="dragLeave(event)" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
  <p style="clear:both;"><strong>注意：</strong>Internet Explorer 8 及更早 IE 版本或 Safari 5.1 及更早版本的浏览器不支持 drag 事件。</p>
  <p id="demo"></p>
  <script>
    function dragStart(event) {
      event.dataTransfer.setData("Text", event.target.id);
    }

    function dragEnter(event) {
      document.getElementById("demo").innerHTML = "进入放置区域";
      if (event.target.className == "droptarget") {
        event.target.style.backgroundColor = "lightblue";
      }
    }

    function dragLeave(event) {
      document.getElementById("demo").innerHTML = "离开放置区域";
      if (event.target.className == "droptarget") {
        event.target.style.backgroundColor = "";
      }
    }

    function allowDrop(event) {
      event.preventDefault();
    }

    function drop(event) {
      event.preventDefault();
      event.target.style.backgroundColor = "";
      var data = event.dataTransfer.getData("Text");
      event.target.appendChild(document.getElementById(data));
    }
  </script>

</body>
</html>

尝试一下 »

JavaScript 中：

object.ondragleave = function() {
  myScript
};
<!DOCTYPE HTML>
<html>
<head>
  <meta charset="utf-8">
  <title>蜜蜂教程(mifengjc.com)</title>
  <style>
    .droptarget {
      float: left;
      width: 100px;
      height: 35px;
      margin: 15px;
      margin-right: 100px;
      padding: 10px;
      border: 1px solid #aaaaaa;
    }
  </style>
</head>
<body>

  <p>该实例演示了如何使用 HTML DOM 向 文档对象添加 "ondragstart", "ondrag", "ondragover" 和 "ondrop" 事件。 </p>
  <p>在两个矩形框中来回拖动 p 元素:</p>
  <div class="droptarget">
    <p draggable="true" id="dragtarget">拖动我!</p>
  </div>
  <div class="droptarget"></div>
  <p style="clear:both;"><strong>注意：</strong>Internet Explorer 8 及更早 IE 版本或 Safari 5.1 及更早版本的浏览器不支持 drag 事件。</p>
  <p id="demo"></p>
  <script>
    /* 拖动时触发*/
    document.ondragstart = function(event) {
      event.dataTransfer.setData("Text", event.target.id);
    };
    /* 拖动完成后触发 */
    document.ondragenter = function(event) {
      if (event.target.className == "droptarget") {
        document.getElementById("demo").innerHTML = "进入放置区域";
        event.target.style.backgroundColor = "lightblue";
      }
    };
    document.ondragover = function(event) {
      event.preventDefault();
    };
    document.ondragleave = function(event) {
      if (event.target.className == "droptarget") {
        document.getElementById("demo").innerHTML = "离开放置区域";
        event.target.style.backgroundColor = "";
      }
    };
    document.ondrop = function(event) {
      event.preventDefault();
      if (event.target.className == "droptarget") {
        event.target.style.backgroundColor = "";
        var data = event.dataTransfer.getData("Text");
        event.target.appendChild(document.getElementById(data));
      }
    };
  </script>

</body>
</html>

尝试一下 »

JavaScript 中, 使用 addEventListener() 方法:

object.addEventListener("dragleave", myScript);
<!DOCTYPE HTML>
<html>
<head>
  <meta charset="utf-8">
  <title>蜜蜂教程(mifengjc.com)</title>
  <style>
    .droptarget {
      float: left;
      width: 100px;
      height: 35px;
      margin: 15px;
      margin-right: 100px;
      padding: 10px;
      border: 1px solid #aaaaaa;
    }
  </style>
</head>
<body>

  <p>该实例演示了如何使用 addEventListener() 方法向文档对象添加 "ondragstart", "ondrag", "ondragover" 和 "ondrop" 事件。 </p>
  <p>在两个矩形框中来回拖动 p 元素:</p>
  <div class="droptarget">
    <p draggable="true" id="dragtarget">拖动我!</p>
  </div>
  <div class="droptarget"></div>
  <p style="clear:both;"><strong>注意：</strong>Internet Explorer 8 及更早 IE 版本或 Safari 5.1 及更早版本的浏览器不支持 drag 事件。</p>
  <p id="demo"></p>
  <script>
    /* 拖动时触发*/
    document.addEventListener("dragstart", function(event) {
      event.dataTransfer.setData("Text", event.target.id);
    });
    /*拖动完成后触发*/
    document.addEventListener("dragenter", function(event) {
      if (event.target.className == "droptarget") {
        document.getElementById("demo").innerHTML = "进入放置区域";
        event.target.style.backgroundColor = "lightblue";
      }
    });
    document.addEventListener("dragover", function(event) {
      event.preventDefault();
    });
    /*拖动完成后触发*/
    document.addEventListener("dragleave", function(event) {
      if (event.target.className == "droptarget") {
        document.getElementById("demo").innerHTML = "离开放置区域";
        event.target.style.backgroundColor = "";
      }
    });
    document.addEventListener("drop", function(event) {
      event.preventDefault();
      if (event.target.className == "droptarget") {
        event.target.style.backgroundColor = "";
        var data = event.dataTransfer.getData("Text");
        event.target.appendChild(document.getElementById(data));
      }
    });
  </script>

</body>
</html>

尝试一下 »

注意： Internet Explorer 8 及更早 IE 版本不支持 addEventListener() 方法。

技术细节
是否支持冒泡: Yes
是否可以取消: No
事件类型: DragEvent
支持的 HTML 标签: All HTML elements

更多实例

以下实例演示了所有的拖放事件：

<!DOCTYPE HTML>
<html>
<head>
  <meta charset="utf-8">
  <title>蜜蜂教程(mifengjc.com)</title>
  <style>
    .droptarget {
      float: left;
      width: 100px;
      height: 35px;
      margin: 15px;
      padding: 10px;
      border: 1px solid #aaaaaa;
    }
  </style>
</head>
<body>

  <p>在两个矩形框中来回拖动 p 元素:</p>
  <div class="droptarget">
    <p draggable="true" id="dragtarget">拖动我!</p>
  </div>
  <div class="droptarget"></div>
  <p style="clear:both;"><strong>注意：</strong>Internet Explorer 8 及更早 IE 版本或 Safari 5.1 及更早版本的浏览器不支持 drag 事件。</p>
  <p id="demo"></p>
  <script>
    /* 拖动时触发*/
    document.addEventListener("dragstart", function(event) {
      //dataTransfer.setData()方法设置数据类型和拖动的数据
      event.dataTransfer.setData("Text", event.target.id);
      // 拖动 p 元素时输出一些文本
      document.getElementById("demo").innerHTML = "开始拖动 p 元素.";
      //修改拖动元素的透明度
      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 = "完成 p 元素的拖动";
      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";
      }
    });
    // 默认情况下,数据/元素不能在其他元素中被拖放。对于drop我们必须防止元素的默认处理
    document.addEventListener("dragover", function(event) {
      event.preventDefault();
    });
    // 当可拖放的p元素离开droptarget，重置div的边框样式
    document.addEventListener("dragleave", function(event) {
      if (event.target.className == "droptarget") {
        event.target.style.border = "";
      }
    });
    /*对于drop,防止浏览器的默认处理数据(在drop中链接是默认打开)
    复位输出文本的颜色和DIV的边框颜色
    利用dataTransfer.getData()方法获得拖放数据
    拖拖的数据元素id(“drag1”)
    拖拽元素附加到drop元素*/
    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>

</body>
</html>

尝试一下 »

相关页面

HTML 教程: HTML5 拖放

HTML 参考手册: HTML draggable 属性


事件对象参考手册 事件对象