ondragenter 事件

事件對象參考手冊 事件對象

實例

在拖動的元素進入到放置目標時執行 JavaScript :

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

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

定義和用法

ondragenter 事件在拖動的元素或選擇的文本進入到有效的放置目標時觸發。

ondragenter 和 ondragleave 事件可以幫助用戶更好的理解可拖動元素進入和離開放置區域的過程。 你可以在可拖動元素進入和離開放置區域時設置不同的背景顏色。

拖放是 HTML5 中非常常見的功能。 更多資訊可以查看我們 HTML 教學中的 HTML5 拖放。

注意： 為了讓元素可拖動，需要使用 HTML5 draggable 屬性。

提示： 鏈接和圖片默認是可拖動的，不需要 draggable 屬性。

在拖放的過程中會觸發以下事件：

  • 在拖動目標上觸發事件 (源元素):
    • ondragstart - 用戶開始拖動元素時觸發
    • ondrag - 元素正在拖動時觸發
    • ondragend - 用戶完成元素拖動後觸發

  • 釋放目標時觸發的事件:
    • ondragenter - 當被滑鼠拖動的對象進入其容器範圍內時觸發此事件
    • ondragover - 當某被拖動的對象在另一對象容器範圍內拖動時觸發此事件
    • ondragleave - 當被滑鼠拖動的對象離開其容器範圍內時觸發此事件
    • ondrop - 在一個拖動過程中，釋放滑鼠鍵時觸發此事件

流覽器支持

表格中的數字表示支持該事件的第一個流覽器的版本號。

事件
ondragenter 4.0 9.0 3.5 6.0 12.0

語法

HTML 中：

<element ondragenter="myScript">

JavaScript 中：

object.ondragenter=function(){myScript};

JavaScript 中, 使用 addEventListener() 方法:

object.addEventListener("dragenter", myScript);

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

技術細節
是否支持冒泡: Yes
是否可以取消: Yes
事件類型: DragEvent
支持的 HTML 標籤: All HTML elements

Examples

更多實例

實例

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

/* 拖動時觸發*/
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));
    }
});


相關頁面

HTML 教學: HTML5 拖放

HTML 參考手冊: HTML draggable 屬性


事件對象參考手冊 事件對象