過去要在網頁上做拖放,幾乎都得靠 JavaScript 硬寫滑鼠事件。HTML5 把這件事收進標準之後,只要一個 draggable 屬性加上一組拖放事件,就能把方塊拖進目標框裡。下面用一個最小範例走一遍完整流程。
<div> <p>把黃色小方塊拖入到紅色大方框中</p> </div> <div id="item" draggable="true"> </div> <div id="drop"> </div>
draggable 是 HTML5 新增的屬性,有三種取值:true 表示可拖曳,false 表示不可拖曳,auto 則交由瀏覽器自行判斷(通常依元素類型決定,例如圖片與連結預設可拖)。細節可參考官方文件。
<style type="text/css">
#drop
{
width: 300px;
height: 200px;
background-color: #ff0000;
padding: 5px;
border: 2px solid #000000;
}
#item
{
width: 100px;
height: 100px;
background-color: #ffff00;
padding: 5px;
margin: 20px;
border: 1px dashed #000000;
}
*[draggable=true] {
-moz-user-select:none;
-khtml-user-drag: element;
cursor: move;
}
*:-khtml-drag {
background-color: rgba(238,238,238, 0.5);
}
</style>
紅框是放置區,黃塊是被拖曳的元素。cursor: move 讓使用者一眼看出這東西可以拖;-khtml-user-drag 與 -moz-user-select 則是舊版瀏覽器的相容寫法,用來避免拖曳時誤選文字。
function listenEvent(eventTarget, eventType, eventHandler) {
if (eventTarget.addEventListener) {
eventTarget.addEventListener(eventType, eventHandler, false);
} else if (eventTarget.attachEvent) {
eventType = "on" + eventType;
eventTarget.attachEvent(eventType, eventHandler);
} else {
eventTarget["on" + eventType] = eventHandler;
}
}
// 取消事件預設行為
function cancelEvent (event) {
if (event.preventDefault) {
event.preventDefault();
} else {
event.returnValue = false;
}
}
// 阻止事件冒泡
function cancelPropagation (event) {
if (event.stopPropagation) {
event.stopPropagation();
} else {
event.cancelBubble = true;
}
}
window.onload = function() {
var target = document.getElementById("drop");
listenEvent(target, "dragenter", cancelEvent);
listenEvent(target, "dragover", dragOver);
listenEvent(target, "drop", function (evt) {
cancelPropagation(evt);
evt = evt || window.event;
evt.dataTransfer.dropEffect = 'copy';
var id = evt.dataTransfer.getData("Text");
target.appendChild(document.getElementById(id));
});
var item = document.getElementById("item");
item.setAttribute("draggable", "true");
listenEvent(item, "dragstart", function(evt) {
evt = evt || window.event;
evt.dataTransfer.effectAllowed = 'copy';
evt.dataTransfer.setData("Text", item.id);
});
};
function dragOver(evt) {
if (evt.preventDefault) evt.preventDefault();
evt = evt || window.event;
evt.dataTransfer.dropEffect = 'copy';
return false;
}
三個自訂的輔助函式都是為了兼顧舊瀏覽器:listenEvent 統一事件綁定寫法,cancelEvent 與 cancelPropagation 分別對應 preventDefault 與 stopPropagation 的相容版本。
真正關鍵的是 dataTransfer 物件。拖曳開始時,透過 setData("Text", item.id) 把被拖元素的 id 寫進去;放下時再用 getData("Text") 讀回來,就能知道該搬動哪個節點。少了這一步,瀏覽器無從得知你拖的是什麼。
另外要注意 dragover 一定要回傳 false 或呼叫 preventDefault(),否則瀏覽器會認為該區域不接受放置,drop 事件根本不會觸發。這是最容易踩到的坑。
整套機制由以下事件組成:
dataTransfer 的內容與 effectAllowed。dragenter 時加的樣式。把這些事件按順序串起來,就能完成想要的功能,上面的程式邏輯並不難讀。
值得提醒的是瀏覽器支援度差異明顯。以當時的情況而言,Opera 的實作最完整,IE 的表現則不理想;實作時建議動手在自己的目標瀏覽器上驗證一遍,並為 dragenter、dragover 這類必要步驟預留相容處理。希望這個範例對你的 Web 開發有所幫助。