網頁中的圖像、鏈接和文本默認就可以被拖動。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 是事件對象的一個屬性,兩個主要方法是 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>
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,能在視覺上明確告訴使用者「這裡可以放」,體驗會好很多。