jqDnR 是一個相當輕巧的拖曳與縮放插件,但在實際使用時會遇到一個惱人的狀況:元素一旦被拖出可視範圍,就再也拉不回來了。本篇記錄了對此問題的修正,讓被拖曳的物件始終被限制在視窗範圍內移動。
關鍵在於拖曳的 drag 函式。原本的版本只單純地依滑鼠位移計算新座標,並未對邊界做任何約束。修正後的做法,是在設定 left 與 top 時加入邊界判斷:小於 0 時歸零,超出視窗可見寬高時則以視窗邊界為上限,藉此把元素牢牢限制在可視區域裡。
以下為加入邊界限制後的 drag 方法片段:
drag: function(v) {
if (M.k == 'd') {
// 加入邊界判斷,避免拖曳後跑出視窗無法拉回
E.css({
left: (M.X + v.pageX - M.pX) < 0 ? 0
: (M.X + v.pageX - M.pX) < document.documentElement.clientWidth - M.W
? (M.X + v.pageX - M.pX)
: document.documentElement.clientWidth - M.W,
top: (M.Y + v.pageY - M.pY) < 0 ? 0
: (M.Y + v.pageY - M.pY) < document.documentElement.clientHeight - M.H
? (M.Y + v.pageY - M.pY)
: document.documentElement.clientHeight - M.H
});
}
else {
E.css({
width: Math.max(v.pageX - M.pX + M.W, 0),
height: Math.max(v.pageY - M.pY + M.H, 0)
});
return false;
}
}
為了保留插件的完整輪廓,以下是含邊界修正的完整 jqDnR 結構:
(function($) {
$.fn.jqDrag = function(h) { return i(this, h, 'd'); };
$.fn.jqResize = function(h) { return i(this, h, 'r'); };
$.jqDnR = {
dnr: {}, e: 0,
drag: function(v) {
if (M.k == 'd') {
E.css({
left: (M.X + v.pageX - M.pX) < 0 ? 0
: (M.X + v.pageX - M.pX) < document.documentElement.clientWidth - M.W
? (M.X + v.pageX - M.pX)
: document.documentElement.clientWidth - M.W,
top: (M.Y + v.pageY - M.pY) < 0 ? 0
: (M.Y + v.pageY - M.pY) < document.documentElement.clientHeight - M.H
? (M.Y + v.pageY - M.pY)
: document.documentElement.clientHeight - M.H
});
}
else {
E.css({ width: Math.max(v.pageX - M.pX + M.W, 0), height: Math.max(v.pageY - M.pY + M.H, 0) });
return false;
}
},
stop: function() {
E.css('opacity', M.o);
$(document).unbind('mousemove', J.drag).unbind('mouseup', J.stop);
}
};
var J = $.jqDnR, M = J.dnr, E = J.e,
i = function(e, h, k) {
return e.each(function() {
h = (h) ? $(h, e) : e;
h.bind('mousedown', { e: e, k: k }, function(v) {
var d = v.data, p = {}; E = d.e;
if (E.css('position') != 'relative') {
p = E.position();
if (!($.browser.msie && ($.browser.version == "6.0")) && (E.css('position') == 'fixed')) {
p.top -= $(window).scrollTop(); p.left -= $(window).scrollLeft()
}
}
M = {
X: p.left || f('left') || 0, Y: p.top || f('top') || 0,
W: f('width') || E[0].scrollWidth || 0,
H: f('height') || E[0].scrollHeight || 0,
pX: v.pageX, pY: v.pageY, k: d.k, o: E.css('opacity')
};
E.css({ opacity: 0.8 });
$(document).mousemove($.jqDnR.drag).mouseup($.jqDnR.stop);
return false;
});
});
},
f = function(k) { return parseInt(E.css(k)) || false; };
})(jQuery);
經過這樣的調整,被拖曳的視窗便不會再跑出畫面之外,使用者體驗也隨之改善許多。