DIV CSS 佈局教程網

原生 JS 拖放機制詳解:draggable、dataTransfer 與 dropEffect
編輯:關於JavaScript     

什麼元素默認可拖動

網頁中的圖像、鏈接和文本默認就可以被拖動。HTML5 為所有 HTML 元素都提供了 draggable 屬性,設為 true 時該元素即被視為可拖動。

拖動圖像或鏈接時,把滑鼠移到上面按住不放即可;拖動文本則需要先選中,再像拖圖像一樣拖走選區。

被拖動元素的事件

拖動過程中依次觸發 dragstart → drag → dragend,這三個事件的目標都是被拖動的元素本身。按下滑鼠並開始移動時觸發 dragstart,隨即觸發 drag 並在整個拖動期間持續觸發;拖動結束後,無論放在有效還是無效的放置目標上,都會觸發 dragend。

放置目標元素的事件

當元素被拖到有效放置目標上時,會依次觸發 dragenter → dragover → drop(或 dragleave)。只要有元素進入放置目標範圍就觸發 dragenter,緊接著是 dragover,並在元素停留其間持續觸發;一旦拖出範圍,dragover 停止並觸發 dragleave;若是在目標內部放開滑鼠,則觸發 drop 而非 dragleave。這幾個事件的目標都是作為放置目標的元素。

瀏覽器支持度方面,Chrome 效果最好,Firefox 支持相對較弱,需要額外處理默認行為。

自定義放置目標

任何元素都能變成有效的放置目標,方法是重寫 dragenter 與 dragover 的默認行為(呼叫 preventDefault())。

在 Firefox 中,放置事件的默認行為是打開被放上去的 URL——拖圖片過去會直接跳轉到圖片文件,拖文本過去則會報無效 URL 錯誤。因此除了 dragenter/dragover,還必須取消 drop 事件的默認行為,才能讓 Firefox 表現正常。

dataTransfer 對象

原生拖放最大的特色,是可以利用拖放事件傳遞數據,讓瀏覽器原生就具備類似桌面應用的拖放交互能力。要使用這個能力,就需要 dataTransfer 接口。

dataTransfer 是事件對象的一個屬性,兩個主要方法是 setData()(保存值)與 getData()(讀取值)。拖動文本框中的文本時,瀏覽器會自動以 "text" 格式把文本存進 dataTransfer;拖動鏈接或圖像時則會保存 URL。元素被放到目標上時,就能用 getData() 讀回來。

保存的數據類型為 "text" 或 "url",HTML5 中分別映射為 "text/plain" 與 "text/uri-list"。兩者有本質區別:存為文本時不做任何特殊處理;存為 URL 時,瀏覽器會把它當成網頁中的鏈接——拖到另一個瀏覽器窗口裡,那個窗口就會直接打開該 URL。

示例:文本拖放

<!DOCTYPE HTML>
<html>
<meta charset="utf-8">
<title>HTML5 文本拖放</title>
<head>
<style type="text/css">
#div1 { width: 220px; height: 185px; padding: 10px; border: 1px solid #aaaaaa; }
</style>
</head>
<body>
<p id="p1">拖動文本到矩形框中:</p>
<div id="div1" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
<br>
<script type="text/javascript">
function allowDrop(ev) {
    ev.preventDefault();
}
function drag(ev) {
    //setData() 設置被拖數據的類型和值
    ev.dataTransfer.setData("Text", document.getElementById("p1").innerHTML);
}
function drop(ev) {
    ev.preventDefault();
    var data = ev.dataTransfer.getData("Text");
    ev.target.innerHTML = data;
}
</script>
</body>
</html>

示例:鏈接拖放

<!DOCTYPE HTML>
<html>
<meta charset="utf-8">
<title>HTML5 鏈接拖放</title>
<head>
<style type="text/css">
#div1 { width: 220px; height: 185px; padding: 10px; border: 1px solid #aaaaaa; }
</style>
</head>
<body>
<a href="https://www.baidu.com" id="aa">鏈接到百度</a>
<div id="div1" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
<br>
<script type="text/javascript">
/* ondragover 事件規定在何處放置被拖動的數據。
   默認情況下無法把數據放到其他元素中,若要允許放置,必須阻止默認行為。 */
function allowDrop(ev) {
    ev.preventDefault();
}
function drag(ev) {
    ev.dataTransfer.setData("URL", document.getElementById('aa').href);
}
function drop(ev) {
    //調用 preventDefault() 避免浏覽器以鏈接形式打開數據
    ev.preventDefault();
    //getData() 返回在 setData() 中設置為相同類型的數據
    var data = ev.dataTransfer.getData("URL");
    ev.target.innerHTML = data;
}
</script>
</body>
</html>

示例:圖片拖放

<!DOCTYPE HTML>
<html>
<meta charset="utf-8">
<title>HTML5 圖片拖放</title>
<head>
<style type="text/css">
#div1 { width: 220px; height: 185px; padding: 10px; border: 1px solid #aaaaaa; }
</style>
</head>
<body>
<p id="p1">拖動圖片到矩形框中:</p>
<div id="div1" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
<br>
<img id="drag1" src="abao.png" draggable="true" ondragstart="drag(event)" width="220" height="181">
<script type="text/javascript">
function allowDrop(ev) {
    ev.preventDefault();
}
function drag(ev) {
    //這裡保存的是可拖動元素的 id
    ev.dataTransfer.setData("Text", ev.target.id);
}
function drop(ev) {
    ev.preventDefault();
    var data = ev.dataTransfer.getData("Text");
    ev.target.appendChild(document.getElementById(data));
}
</script>
</body>
</html>

示例:圖片在兩個容器間來回拖放

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>圖片來回拖放</title>
<style type="text/css">
div {
    width: 230px; height: 185px;
    padding: 10px;
    float: left;
    margin-right: 10px;
    border: 1px solid #ccc;
}
</style>
</head>
<body>
<div id="box1" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
<div id="box2" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
<img src="abao.png" id="drag1" draggable="true" ondragstart="drag(event)">
<script type="text/javascript">
function allowDrop(ev) {
    ev.preventDefault();
}
function drag(ev) {
    ev.dataTransfer.setData("Text", ev.target.id);
}
function drop(ev) {
    ev.preventDefault();
    var data = ev.dataTransfer.getData("Text");
    ev.target.appendChild(document.getElementById(data));
}
</script>
</body>
</html>

dropEffect 與 effectAllowed

dataTransfer 除了傳輸數據,還能用來約定「被拖動的元素」與「放置目標」各自能接受哪種操作,靠的就是這兩個屬性。

dropEffect 決定浏覽器顯示什麼樣的光標,從側面提示使用者放開後會發生什麼。它的取值有:

none:不能把拖動的元素放在這裡
move:應把拖動的元素移動到放置目標
copy:應把拖動的元素復制到放置目標
link:放置目標會打開拖動的元素(該元素必須是有 URL 的鏈接)

浏覽器只負責幫你換光標,具體效果仍要開發者自己實現。

effectAllowed 表示允許拖動元素具備哪些 dropEffect 行為,取值有:

uninitialized:未給被拖動元素設置任何放置行為
none:被拖動的元素不能有任何行為
copy:只允許 copy
link:只允許 link
move:只允許 move
copyLink:允許 copy 與 link
copyMove:允許 copy 與 move
linkMove:允許 link 與 move
all:允許所有放置行為

注意:effectAllowed 必須在 ondragstart 事件處理程序中設置。

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>dropEffect and effectAllowed</title>
</head>
<body>
<a href="https://www.baidu.com">鏈接到百度</a>
<div style="width: 200px; height: 100px; float: right; background: red" id="droptarget"></div>
<div id="output"></div>
<script type="text/javascript" src="EventUtil.js"></script>
<script type="text/javascript">
var droptarget = document.getElementById("droptarget");  //獲取放置目標
var link = document.links[0];

function handleEvent(event) {
    document.getElementById("output").innerHTML += event.type + "<br>";
    switch (event.type) {
        case "dragstart":
        case "dragend":
            //表示放置目標會打開拖動的元素
            event.dataTransfer.dropEffect = "link";
            break;
        case "dragenter":
        case "dragover":
            EventUtil.preventDefault(event);
            //表示只允許 link 類型的 dropEffect
            event.dataTransfer.effectAllowed = "link";
            break;
        case "drop":
        case "dragleave":
            droptarget.innerHTML = event.dataTransfer.getData("url")
                || event.dataTransfer.getData("text/uri-list");
    }
}

EventUtil.addHandler(droptarget, "dragenter", handleEvent);
EventUtil.addHandler(droptarget, "dragover", handleEvent);
EventUtil.addHandler(droptarget, "dragleave", handleEvent);
EventUtil.addHandler(droptarget, "drop", handleEvent);
EventUtil.addHandler(link, "dragstart", handleEvent);
EventUtil.addHandler(link, "dragend", handleEvent);
</script>
</body>
</html>

把上面示例中的 link 換成 move,並在 drop 中加上 EventUtil.preventDefault(event) 阻止浏覽器打開 URL,就得到「移動」語義的版本:

var droptarget = document.getElementById("droptarget");
var link = document.links[0];

function handleEvent(event) {
    document.getElementById("output").innerHTML += event.type + "<br>";
    switch (event.type) {
        case "dragstart":
        case "dragend":
            event.dataTransfer.dropEffect = "move";  //應該把拖動的元素移動到放置目標
        case "dragenter":
        case "dragover":
            EventUtil.preventDefault(event);
            event.dataTransfer.effectAllowed = "move";  //只允許 move
            break;
        case "drop":
        case "dragleave":
            EventUtil.preventDefault(event);
            //阻止放置事件的默認行為:打開被放到放置目標上的 URL
            droptarget.innerHTML = event.dataTransfer.getData("Text");
    }
}

實作時還有一個實用技巧:拖放過程中給放置目標加一個高亮 class,能在視覺上明確告訴使用者「這裡可以放」,體驗會好很多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved