幾年前參與一個房仲網站專案,我負責前端。當時產品經理參考了很多同類網站的優良設計,想把最好的都集合起來,於是設計稿與功能改了又改,今天做好的效果明天可能就推翻重做。
其中有一個功能他特別喜歡:頁面上一張大圖可以上下左右拖動,圖上的樓棟標記會跟著一起移動。那時我的 JS 功力還不夠,做不出他想要的樣子,後來這個效果就被換掉了。

雖然最終沒有上線,但它一直留在我心裡。所以寫了這篇,給想實作拖拽卻不知道從何下手的同學一個思路。拖拽的做法很多,這裡只講原生 JavaScript 的一種。
精確的描述是:滑鼠移到容器上、按下不放、拖曳,容器跟著滑鼠跑;放開後容器停在原地。就像桌上放一個盒子,手按在盒子上移動,手停盒子停,手放開盒子就不動了。
換成程式語言,就是三個事件:
拖拽 = 滑鼠按下 + 滑鼠移動 + 滑鼠放開,對應 onmousedown、onmousemove、onmouseup。
obj.onmousedown = function(ev){ obj.onmousemove = function(ev){ } ; obj.onmouseup = function(ev){ }; }
後兩個事件寫在裡面是有原因的:只有在按下之后才需要追蹤移動,放開就要解除,寫在內部可以確保事件不會一直掛著。
元素必須是定位元素(因為要改 left 與 top),而滑鼠本身帶有位移資訊。只要知道滑鼠移動了多少,把這個距離套到元素上,元素就跟著移動了。

滑鼠座標可以用 event.clientX 與 event.clientY 取得,它是相對於瀏覽器可視區域的。

計算方式有兩種。左圖是初始位置、右圖是目標位置,原點為滑鼠位置。做法一是「用滑鼠最終位置減去滑鼠與元素的初始差值」;做法二是「用滑鼠位移量加上元素初始的 left/top」。兩者等價,這裡示範第一種:
obj.onmousedown = function(ev){ var ev = ev || event; var disX = ev.clientX - this.offsetLeft,disY = ev.clientY - this.offsetTop; document.onmousemove = function(ev){ var ev = ev || event; obj.style.left = ev.clientX - disX + 'px'; obj.style.top = ev.clientY - disY + 'px'; }; document.onmouseup = function(ev){ var ev = ev || event; document.onmousemove = document.onmouseup = null; }; }
disX、disY 就是「滑鼠位置與元素位置的差值」,按下時記住,移動時反推即可。之所以把 onmousemove 掛在 document 而非 obj 上,是因為滑鼠游標很可能在拖曳途中移出元素範圍,掛在元素上就會跟不上。最後在放開時把兩個事件清空。
細心的人會發現:拖曳時頁面上的文字會被反白選取,這是因為觸發了瀏覽器的預設選取行為,必須阻止事件冒泡:
if(ev.stopPropagation){ ev.stopPropagation(); }else{ ev.cancelBubble = true; //兼容IE } //簡寫成 ev.stopPropagation ? ev.stopPropagation() : ev.cancelBubble = true;
放在 onmousedown 裡即可。當然,用 CSS 的 user-select: none 會更乾淨。
如果希望元素只能在某個容器內移動、拖到邊緣就拖不動,思路其實很生活化:現實中物體跑不出盒子是因為有牆,那我們只要把 left 或 top 鎖住,讓它不能再增加,就等於砌了一道牆。
//左側 if(obj.offsetLeft <=0){ obj.style.left = 0; }; //右側 if(obj.offsetLeft >= pWidth - oWidth){ obj.style.left = pWidth - oWidth + 'px'; }; //上面 if(obj.offsetTop <= 0){ obj.style.top = 0; }; //下面 if(obj.offsetTop >= pHeight - oHeight){ obj.style.top = pHeight - oHeight + 'px'; };
說明:pWidth、pHeight 是父元素的寬高,oWidth、oHeight 是被拖曳元素的寬高。
/* 參數說明: 元素絕對定位,父級相對定位 傳一個參數,表示父級為window,元素相對於window範圍拖動 傳2個參數,則父級為第二個參數,元素相對於父級範圍拖動 參數為id值 */ function drag(obj,parentNode){ var obj = document.getElementById(obj); if(arguments.length == 1){ var parentNode = window.self; var pWidth = parentNode.innerWidth,pHeight = parentNode.innerHeight; }else{ var parentNode = document.getElementById(parentNode); var pWidth = parentNode.offsetWidth,pHeight = parentNode.offsetHeight; } obj.onmousedown = function(ev){ var ev = ev || event; var disX = ev.clientX - this.offsetLeft,disY = ev.clientY - this.offsetTop; var oWidth = obj.offsetWidth,oHeight = obj.offsetHeight; ev.stopPropagation ? ev.stopPropagation() : ev.cancelBubble = true; document.onmousemove = function(ev){ var ev = ev || event; obj.style.left = ev.clientX - disX + 'px'; obj.style.top = ev.clientY - disY + 'px'; //左側 if(obj.offsetLeft <=0){ obj.style.left = 0; }; //右側 if(obj.offsetLeft >= pWidth - oWidth){ obj.style.left = pWidth - oWidth + 'px'; }; //上面 if(obj.offsetTop <= 0){ obj.style.top = 0; }; //下面 if(obj.offsetTop >= pHeight - oHeight){ obj.style.top = pHeight - oHeight + 'px'; }; }; document.onmouseup = function(ev){ var ev = ev || event; document.onmousemove = document.onmouseup = null; }; } }
傳一個參數時以 window 為範圍,傳兩個參數時以指定父元素為範圍。
css:
<style> .box{ width:600px; height:400px; margin:50px auto; position:relative; overflow:hidden; } #box{ width:1000px; height:800px; position:absolute; left:50%; top:50%; margin:-400px 0 0 -500px; } #pic{ width:800px; height:600px; background:url(images/pic1.jpg) no-repeat; position:absolute; left:100px; top:100px; } #pic:hover{ cursor:move; } </style>
html:
<div class="box"> <div id="box"> <div id="pic"></div> </div> </div>
javascript:
window.onload = function(){ drag("pic","box"); function drag(obj,parentNode){ var obj = document.getElementById(obj); if(arguments.length == 1){ var parentNode = window.self; var pWidth = parentNode.innerWidth,pHeight = parentNode.innerHeight; }else{ var parentNode = document.getElementById(parentNode); var pWidth = parentNode.offsetWidth,pHeight = parentNode.offsetHeight; } obj.onmousedown = function(ev){ var ev = ev || event; var disX = ev.clientX - this.offsetLeft,disY = ev.clientY - this.offsetTop; var oWidth = obj.offsetWidth,oHeight = obj.offsetHeight; ev.stopPropagation ? ev.stopPropagation() : ev.cancelBubble = true; document.onmousemove = function(ev){ var ev = ev || event; obj.style.left = ev.clientX - disX + 'px'; obj.style.top = ev.clientY - disY + 'px'; if(obj.offsetLeft <=0){ obj.style.left = 0; }; if(obj.offsetLeft >= pWidth - oWidth){ obj.style.left = pWidth - oWidth + 'px'; }; if(obj.offsetTop <= 0){ obj.style.top = 0; }; if(obj.offsetTop >= pHeight - oHeight){ obj.style.top = pHeight - oHeight + 'px'; }; }; document.onmouseup = function(ev){ var ev = ev || event; document.onmousemove = document.onmouseup = null; }; } } }
外層 .box 用 overflow:hidden 裁切,內層 #box 是一個比視窗更大的定位層,圖片再掛在它裡面,這樣拖動時才不會露出邊角。
最後說一個實務問題:這份封裝是用 id 取得元素,一個頁面只能各用一次。解法有兩個:一是給不同實例命名不同的 id;二是把取得元素的方式改成 getElementsByClassName,但要注意它回傳的是集合,需要多繞一層。有興趣可以自己改寫看看。