好久沒更新部落格了,趁著這週的空閒,把以前用原生 JS 寫過的 div 拖拽效果,改寫成一個 jQuery 小插件,順便當作製作 jQuery 插件的練習。
頁面中有一個大容器 #box,裡面放兩個可拖動的方塊,並用不同參數呼叫插件:
<div id="box">
<div class="float-box"></div>
<div class="float-box1"></div>
</div>
<script type="text/javascript" src="https://code.jquery.com/jquery-1.7.2.min.js"></script>
<script type="text/javascript" src="JQ.MoveBox.js"></script>
<script type="text/javascript">
$(".float-box").MoveBox();
$(".float-box1").MoveBox({out:true});
</script>
相關樣式讓方塊用絕對定位並加上 cursor:move,提示可拖動:
#box{width:500px;height:500px;margin:200px auto;position:relative;border:1px solid #ccc;}
.float-box{width:100px;height:100px;background:#000;color:#fff;position:absolute;top:20px;left:10px;cursor:move;z-index:2;border:2px solid #ccc;border-right:10px solid #fc0;}
.float-box1{width:200px;height:200px;background:#f30;color:#fff;position:absolute;top:0;left:200px;cursor:move;border-top:10px solid #000;}
插件透過 $.fn.MoveBox 擴充,在 mousedown 時計算滑鼠與元素的偏移量並綁定 mousemove,mouseup 時解除綁定。透過 out 參數決定是否允許拖出容器邊界:
(function($){
var n = 1;
var o = {};
$.fn.MoveBox = function(options){
var opts = $.extend({}, $.fn.MoveBox.defaults, options);
return this.each(function(i){
$(this).mousedown(function(e){
o.iTop = $(this).position().top - e.pageY;
o.iLeft = $(this).position().left - e.pageX;
n++;
$this = $(this);
$this.css({'z-index': n});
$(document).bind("mousemove", function(e){
var iLeft = e.pageX + o.iLeft;
var iTop = e.pageY + o.iTop;
if (opts.out) {
// 限制在整個文件可視範圍內
if (iLeft < -$this.parent().offset().left - parseInt($this.parent().css("border-left-width"))) {
iLeft = -$this.parent().offset().left - parseInt($this.parent().css("border-left-width"));
} else if (iLeft > $(document).width() - $this.width() - parseInt($this.css("border-left-width")) - parseInt($this.css("border-right-width")) - $this.parent().offset().left - parseInt($this.parent().css("border-left-width"))) {
iLeft = $(document).width() - $this.width() - parseInt($this.css("border-left-width")) - parseInt($this.css("border-right-width")) - $this.parent().offset().left - parseInt($this.parent().css("border-left-width"));
}
if (iTop < -$this.parent().offset().top - parseInt($this.parent().css("border-top-width")) + $(document).scrollTop()) {
iTop = -$this.parent().offset().top - parseInt($this.parent().css("border-top-width")) + $(document).scrollTop();
} else if (iTop > $(window).height() + $(document).scrollTop() - $this.height() - parseInt($this.css("border-top-width")) - parseInt($this.css("border-bottom-width")) - $this.parent().offset().top - parseInt($this.parent().css("border-top-width"))) {
iTop = $(window).height() + $(document).scrollTop() - $this.height() - parseInt($this.css("border-top-width")) - parseInt($this.css("border-bottom-width")) - $this.parent().offset().top - parseInt($this.parent().css("border-top-width"));
}
} else {
// 限制在父容器內
if (iLeft < 0) {
iLeft = 0;
} else if (iLeft > $this.parent().width() - $this.width() - parseInt($this.css("border-left-width")) - parseInt($this.css("border-right-width"))) {
iLeft = $this.parent().width() - $this.width() - parseInt($this.css("border-left-width")) - parseInt($this.css("border-right-width"));
}
if (iTop < 0) {
iTop = 0;
} else if (iTop > $this.parent().height() - $this.height() - parseInt($this.css("border-top-width")) - parseInt($this.css("border-bottom-width"))) {
iTop = $this.parent().height() - $this.height() - parseInt($this.css("border-top-width")) - parseInt($this.css("border-bottom-width"));
}
}
$this.css({
'left': iLeft + "px",
'top': iTop + "px"
});
});
$(document).bind("mouseup", function(){
$(document).unbind("mousemove");
$(document).unbind("mouseup");
});
});
});
};
$.fn.MoveBox.defaults = {
out: false // 默認不可跑出界外
};
})(jQuery);
透過 z-index 遞增,被拖動的方塊會自動浮到最上層,這是小插件中很實用的小細節。