浮動視窗、浮動工具列、可拖動的公告框,都是同一類需求。原理只有一個:在按下時記住「游標位置與元素左上角的差距」,移動時用這個差距反推新位置。
效果體驗:https://www.keleyi.com/keleyi/phtml/dragdiv.htm
把游標移到方塊上、按住不放,就可以拖動它。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>jQuery 實現可拖動的浮動層</title>
<script type="text/javascript" src="jquery-1.8.2.min.js"></script>
<style type="text/css">
.box{
position: absolute; /* 必須定位才能用 left/top 移動 */
top: 200px;
left: 400px;
width: 200px;
height: 200px;
background: #8a9bca;
cursor: move; /* 提示可拖動 */
}
</style>
<script type="text/javascript">
$(document).ready(function (e) {
var iDiffX = 0, iDiffY = 0; // 游標與元素左上角的差距
$(".box").mousedown(function (e) {
// 記下按下瞬間的差值
iDiffX = e.pageX - $(this).offset().left;
iDiffY = e.pageY - $(this).offset().top;
// 拖曳事件綁在 document 上,游標移出元素外仍能繼續拖
$(document).mousemove(function (e) {
$(".box").css({
"left": (e.pageX - iDiffX),
"top": (e.pageY - iDiffY)
});
});
});
// 放開時解除 mousemove,拖曳結束
$(".box").mouseup(function () {
$(document).unbind("mousemove");
});
});
</script>
</head>
<body style="width:2000px">
<div>歡迎光臨!</div>
<div class="box" id="Drigging">
光標移動到層上,按住鼠標就可以拖動該層。
</div>
<div>www.keleyi.com</div>
</body>
</html>
如果直接把游標座標設成元素的 left/top,會發生「方塊左上角瞬間跳到游標位置」的錯位。因為使用者是在方塊的某個點按下,不一定正中左上角。
記下 iDiffX = 游標x − 元素left 之後,每次移動就用 游標x − iDiffX 當新的 left,元素相對游標的握持位置就永遠保持不變,拖起來才有「抓住一個東西在移動」的手感。
若把 mousemove 綁在 .box 上,當游標移速快過方塊、衝出方塊邊界時,事件就不再觸發,拖曳會中斷。綁在 document 上,無論游標跑到哪裡都能持續收到事件,拖曳才順暢。
1. mouseup 綁錯對象。原範例把 mouseup 綁在 .box 上,但拖曳時游標很可能已經在方塊外面,此時在方塊上放開滑鼠不會觸發 mouseup,mousemove 永遠解除不掉,方塊從此黏在游標上。正確做法是把 mouseup 綁在 document 上:
$(document).on('mouseup', function () {
$(document).off('mousemove');
});
2. 事件累積。每次 mousedown 都重新綁一次 mousemove,若沒有確實解除,處理函式會越堆越多,拖曳越來越卡。除了正確解除,也可以在 mousedown 時先 .off('mousemove') 再 .on(),確保只有一個。
3. 用 on/off 取代 bind/unbind。jQuery 3 已移除 .bind() 與 .unbind(),請改用 .on() 與 .off()。
目前的版本可以把方塊拖到視窗外救不回來。加一個邊界限制就能避免:
$(document).mousemove(function (e) {
var $box = $(".box");
var maxLeft = $(window).width() - $box.outerWidth();
var maxTop = $(window).height() - $box.outerHeight();
var left = Math.min(Math.max(e.pageX - iDiffX, 0), maxLeft);
var top = Math.min(Math.max(e.pageY - iDiffY, 0), maxTop);
$box.css({ left: left, top: top });
});
其他常見補強:拖曳時在 body 上加一個 class 設 user-select:none,避免拖動時把文字選 highlights 起來;在 selectstart 事件回傳 false 達到同樣效果;用 transform: translate() 取代 left/top,只觸發合成而不觸發重排,效能更好。
如果你的需求是「可拖曳、可縮放、有最小化的視窗元件」,已經有 jQuery UI 的 .draggable() 與 .resizable() 現成可用,處理了邊界、對齊、grid 吸附、觸控事件等大量邊界狀況。除非是為了學習原理,否則沒必要重造。而若是新專案,直接用 Pointer Events(pointerdown/pointermove/pointerup)搭配 setPointerCapture,能一次搞定滑鼠、觸控與手寫筆,比分別處理 mouse 與 touch 事件乾淨得多。