頁面上那種「抓標題列就能拖來拖去」的小浮窗,實作起來出乎意料地簡單。關鍵觀念是:不要記錄滑鼠位置,要記錄滑鼠位置與視窗位置的「差值」。抓住這個偏移量,拖曳就完全不會跳動。
<div id="div1" style="position:absolute; top:60px; left:200px;
width:360px; height:250px; background:#FFFF00;">
<div id="title" style="background:#30608F; padding:2px; color:#FFF;
cursor:move; text-indent:5px;">標題</div>
<img id="close" src="close.gif" width="15" height="15" alt="關閉"
style="position:absolute; right:2px; top:2px;" />
</div>
兩個必要條件:容器必須是 position:absolute(否則 left/top 無效),標題列要給 cursor:move 讓使用者知道這裡可以抓。
按下時先算「視窗左上角 − 滑鼠位置」,這個差值在整個拖曳過程中保持不變;移動時只要把差值加回目前滑鼠位置,就是新的左上角座標。
let dragging = null; // 目前被抓的視窗
let offsetX = 0, offsetY = 0;
const panel = document.getElementById('div1');
const title = document.getElementById('title');
title.addEventListener('mousedown', e => {
dragging = panel;
offsetX = panel.offsetLeft - e.clientX;
offsetY = panel.offsetTop - e.clientY;
e.preventDefault(); // 避免選取到文字
});
document.addEventListener('mousemove', e => {
if (!dragging) return;
dragging.style.left = (e.clientX + offsetX) + 'px';
dragging.style.top = (e.clientY + offsetY) + 'px';
});
document.addEventListener('mouseup', () => { dragging = null; });
為什麼差值法比「直接抓滑鼠位移」好?因為使用者不一定抓在視窗左上角。若直接用 e.clientX 當 left,視窗會瞬間跳到「左上角貼著游標」,也就是所謂的「跳位」。減去差值之後,游標抓在哪一點,那一點就永遠黏在游標上。
監聽要掛在 document 上。如果只掛在標題列,滑鼠一旦移出標題範圍,mousemove 就收不到了,視窗會卡住。掛在 document 才能保證整個拖曳過程不中斷。
記得 preventDefault。不擋的話,拖曳時會把標題文字反白選取,畫面看起來很糟。若浮窗內有 input,也應該一併排除拖曳觸發。
關閉按鈕不要觸發拖曳。把 close 圖示放在容器上而非標題列裡,就能天然避開;若必須放在標題列內,則要在它的 mousedown 上 stopPropagation()。
如果同時要支援滑鼠、觸控與手寫筆,用 Pointer Events 一次搞定,不必再分別處理 touchstart:
title.addEventListener('pointerdown', e => {
dragging = panel;
offsetX = panel.offsetLeft - e.clientX;
offsetY = panel.offsetTop - e.clientY;
title.setPointerCapture(e.pointerId); // 讓後續事件都導向標題列
});
title.addEventListener('pointermove', e => {
if (!dragging) return;
panel.style.left = (e.clientX + offsetX) + 'px';
panel.style.top = (e.clientY + offsetY) + 'px';
});
title.addEventListener('pointerup', () => { dragging = null; });
setPointerCapture 是這裡的關鍵:即使游標移出元素範圍,事件仍會持續派發給它,因此不必再依賴 document 上的全域監聽。
邊界限制(避免視窗被拖出畫面外)、拖曳結束後把座標寫入 localStorage 記住位置、以及雙擊標題列最大化/還原,都是幾行就能加上的功能。若要對稱的關閉動畫,可用 CSS transition 搭配 opacity 與 transform: scale(),取代舊 IE 才有的 revealTrans 濾鏡。
這個範例最值得帶走的是那個 offset 技巧——凡是「拖曳」相關的互動,無論是浮窗、分割線、排序列表還是自訂 slider,都建立在這三行的邏輯上。