JavaScript 实现鼠标拖动元素

一、前言

最开始实现鼠标拖动元素的目的就是在一个页面上拖动很多小圆点,用于固定定位,然后在复制HTML,粘贴在页面的开发代码中,就是这么一个功能,实现了很多遍,都没有做好,不得已采用了jQuery.fn.draggable插件,在接触一些资料和别人的思路,今天终于把这个拖动功能给完善了,下面就来看看它的实现

DEMO1:http://jsfiddle.net/Jj9qA/4/
DEMO2: http://jsfiddle.net/gUYdg/1/

 

二、设计思路

在拖动元素上绑定鼠标按下事件,在文档对象中绑定鼠标移动,鼠标弹起事件;
为什么不把三个事件都绑定在拖动元素上,这是因为鼠标移动太快时,鼠标移动和弹起事件处理程序将不会执行

$target.bind('mousedown', fn);



$(document)

.bind('mousemove', fn)

.bind('mouseup', fn);

 

三、源码实现细节

在实现源码中有很多需要值得注意的地方:

1、首先在鼠标按下事件中,当单击拖动元素中,可能会选择区域文字,这并不是我们所需要的,解决方法如下:

// 阻止区域文字被选中 for chrome firefox ie9

e.preventDefault();

// for firefox ie9 || less than ie9

window.getSelection ? window.getSelection().removeAllRanges() : document.selection.empty();


2、如果拖动元素是图片(img标签),鼠标在拖动图片一小段距离,会出现一个禁止的小提示,即:图片不能再拖动,
这是浏览器的默认行为,因此只要阻止浏览器默认行为就可以了

e.preventDefault();


3、关于边界(处理拖动范围)的问题

一开始实现的代码如下:

// x,y代表拖动元素将要设置的left,top值,limitObj为拖动区域范围对象,测试时就发现问题,

// 在拖动过程中,拖动对象有时不能直接靠近边界



if ( x >= limitObj._left && x <= limitObj._right ) {

    $target.css({ left: x + 'px' });

}

if ( y >= limitObj._top && y <= limitObj._bottom ) {

    $target.css({ top: y + 'px' });

}

 

进一步思考:为什么会出现上面问题,原因在于变量x可能会小于limitObj._left或大于limitObj._right,变量y同理,
因此代码需要像下面这样处理:

if (x < limitObj._left) {

    x = limitObj._left;

}

if (x > limitObj._right) {

    x = limitObj._right;

}

if (y < limitObj._top) {

    y = limitObj._top;

}

if (y > limitObj._bottom) {

    y = limitObj._bottom;

}

$target.css({ left: x + 'px', top: y + 'px' });

 

终于解决了这个问题,但是cloudgamer给出了更好的写法:

$target.css({

    left: Math.max( Math.min(x, limitObj._right),  limitObj._left) + 'px',

    top: Math.max( Math.min(y, limitObj._bottom),  limitObj._top) + 'px'

});

 

完整程序源码

$.fn.extend({

    /**

     *   Autor: 博客园华子yjh 2014/02/21

     */

    drag: function(options) {

        var dragStart, dragMove, dragEnd,

            $boundaryElem, limitObj;



        function _initOptions() {

            var noop = function(){}, defaultOptions;



            defaultOptions = { // 默认配置项

                boundaryElem: 'body' // 边界容器

            };

            options = $.extend( defaultOptions, options || {} );

            $boundaryElem = $(options.boundaryElem);



            dragStart = options.dragStart || noop,

            dragMove = options.dragMove || noop,

            dragEnd = options.dragEnd || noop;

        }



        function _drag(e) {

            var clientX, clientY, offsetLeft, offsetTop,

                $target = $(this), self = this;



            limitObj = {

                _left: 0,

                _top: 0,

                _right: ($boundaryElem.innerWidth() || $(window).width()) - $target.outerWidth(),

                _bottom: ($boundaryElem.innerHeight() || $(window).height()) - $target.outerHeight()

            };

            

            // 记录鼠标按下时的位置及拖动元素的相对位置

            clientX = e.clientX;

            clientY = e.clientY;

            offsetLeft = this.offsetLeft;

            offsetTop = this.offsetTop;

            

            dragStart.apply(this, arguments);

            $(document).bind('mousemove', moveHandle)

                        .bind('mouseup', upHandle);



            // 鼠标移动事件处理

            function moveHandle(e) {

                var x = e.clientX - clientX + offsetLeft;

                var y = e.clientY - clientY + offsetTop;

                

                $target.css({

                    left: Math.max( Math.min(x, limitObj._right),  limitObj._left) + 'px',

                    top: Math.max( Math.min(y, limitObj._bottom),  limitObj._top) + 'px'

                });



                dragMove.apply(self, arguments);

                // 阻止浏览器默认行为(鼠标在拖动图片一小段距离,会出现一个禁止的小提示,即:图片不能再拖动)

                e.preventDefault();

            }



            // 鼠标弹起事件处理

            function upHandle(e) {

                $(document).unbind('mousemove', moveHandle);

                dragEnd.apply(self, arguments);

            }

        }



        _initOptions(); // 初始化配置对象



        $(this)

        .css({ position: 'absolute' })

        .each(function(){

            $(this).bind('mousedown', function(e){

                _drag.apply(this, [e]);

                // 阻止区域文字被选中 for chrome firefox ie9

                e.preventDefault();

                // for firefox ie9 || less than ie9

                window.getSelection ? window.getSelection().removeAllRanges() : document.selection.empty();

            });

        });

        return this;

    }

});

实例调用:

// 调用实例

(function(){

    $('.drag-elem').drag({

        boundaryElem: '#boundary',

        dragStart: function(){

            $(this).html('<span>准备拖动</span>').css({ zIndex: 2 }).siblings().css({ zIndex: 1 });

        },

        dragMove: function(){

            var pos = $(this).position();

            $(this).html('<span>拖动中(' +  pos.left + ',' + pos.top + ')</span>' );

        },

        dragEnd : function(){

            $(this).html('<span>拖动结束</span>');            

        }

    });

}());

 

2014/03/02 源码更新及demo:

$.fn.extend({

    /**

     *   Autor: 博客园华子yjh update 2014/03/02

     */

    drag: function(options) {

        var dragStart, dragMove, dragEnd,



            $boundaryElem, b_width, b_height,

            limitObj, isBeyond, diffX, diffY,



            win_width = $(window).width(),

            win_height = $(window).height();



        function _initOptions() {

            var noop = function(){}, defaultOptions;



            defaultOptions = {          // 默认配置项

                boundaryElem: 'body',   // 边界容器

                isLimit: false          // 是否限制拖动范围

            };

            options = $.extend( defaultOptions, options || {} );



            // 边界元素及其宽高

            $boundaryElem = $(options.boundaryElem);

            b_width = $boundaryElem.innerWidth();

            b_height = $boundaryElem.innerHeight();



            dragStart = options.dragStart || noop,

            dragMove = options.dragMove || noop,

            dragEnd = options.dragEnd || noop;

        }



        function _drag(e) {

            var clientX, clientY, offsetLeft, offsetTop, width, height,

                $target = $(this), self = this;

            

            // 记录鼠标按下时的位置及拖动元素的相对位置

            clientX = e.clientX;

            clientY = e.clientY;

            offsetLeft = this.offsetLeft;

            offsetTop = this.offsetTop;



            width = $target.outerWidth();

            height = $target.outerHeight();            



            limitObj = {

                _left: 0,

                _top: 0,

                _right: (b_width || win_width) - width,

                _bottom: (b_height || win_height) - height

            };

            

            // 拖动元素是否超出了限制边界

            isBeyound = width > b_width && height > b_height;

            if (isBeyound) {

                diffX = b_width - width;

                diffY = b_height - height;

            }

            

            dragStart.apply(this, arguments);

            $(document).bind('mousemove', moveHandle)

                        .bind('mouseup', upHandle);



            // 鼠标移动事件处理

            function moveHandle(e) {

                var e_diffX = e.clientX - clientX,

                    e_diffY = e.clientY - clientY,

                    x = e_diffX + offsetLeft,

                    y = e_diffY + offsetTop;



                if (options.isLimit && !isBeyound) {

                    x = Math.max( Math.min(x, limitObj._right),  limitObj._left );

                    y = Math.max( Math.min(y, limitObj._bottom),  limitObj._top );

                }



                if (options.isLimit && isBeyound) {

                    x = e_diffX < 0 ? Math.max(x, diffX) : Math.min(x, 0);

                    y = e_diffY < 0 ? Math.max(y, diffY) : Math.min(y, 0);

                }



                $target.css({

                    left: x + 'px',

                    top: y + 'px'

                });



                dragMove.apply(self, arguments);

                // 阻止浏览器默认行为(鼠标在拖动图片一小段距离,会出现一个禁止的小提示,即:图片不能再拖动)

                e.preventDefault();

            }



            // 鼠标弹起事件处理

            function upHandle(e) {

                $(document).unbind('mousemove', moveHandle);

                dragEnd.apply(self, arguments);

            }

        }



        _initOptions(); // 初始化配置对象



        $(this)

        .css({ position: 'absolute' })

        .each(function(){

            $(this).bind('mousedown', function(e){

                if ($(this).data('data-resize')) {

                    return;

                }

                _drag.apply(this, [e]);

                // 阻止区域文字被选中 for chrome firefox ie9

                e.preventDefault();

                // for firefox ie9 || less than ie9

                window.getSelection ? window.getSelection().removeAllRanges() : document.selection.empty();

            });

        });

        return this;

    }

});
View Code

demo:http://jsfiddle.net/aTB2H/

 

PS: 如有描述错误,请帮忙指正,如果你们有不明白的地方也可以发邮件给我,

  如需转载,请附上本文地址及出处:博客园华子yjh,谢谢!

你可能感兴趣的:(JavaScript)