|
译者:
Flyingis
终于完成了全文的翻译,由于时间比较参促,文章没有过多的校正与润色,阅读过程中难免会有些许生硬或不准确的感觉,请大家见量并指出,方便他人阅读。
原文作者将拖放功能的实现分步讲解,其核心的地方在于移动和放置元素时,鼠标、移动元素、目标元素关系的处理,只要这个问题处理好了,代码就很容易理解,译文仅供辅助参考之用。
整合所有的功能
最后我们使用所有代码片断,来创建一个完整的拖放函数脚本。我们所要做的第一件事情是DOM操作,如果你对此并不十分熟悉,可以阅读《
JavaScript Primer on DOM Manipulation
》。
接下来的代码创建容器和容器组,使得在这些容器中可以拖动每个元素,这在本文第二个demo的基础上来完成。这段代码能够用来重新规划元素的顺序,将导航窗口放在页面的左侧或右侧,或再加入你所能想到的其他的功能。
我们将使用伪代码来一步步进行讲解,将真实的代码通过注释的方式留给读者查看。
1.当文档第一次被加载时,我们创建一个名为dragHelper的DIV标签,当我们开始移动一个元素的时候,dragHelper将成为一个隐藏元素,可以四处移动。真实的元素并不会被拖动,仅仅使用insertBefore和appendChild来移动。我们在开始的时候隐藏dragHelper。
2.我们创建mouseDown和mouseUp函数。起初,所有的这些函数都假设记录了鼠标按钮的状态,以至于iMouseDown变量在鼠标按下的时候为true,没有按下的时候为false。
3.我们创建一个全局变量DragDrops,以及一个函数CreateDragContainer。DragDrops包含一组相互关联的容器。传入CreateDragContainer的任何变量(代表容器)被组织成一个新的集合,使元素能够在这些容器间自由移动。通过setAttribute,CreateDragContainer函数同样将各容器中的元素绑定在一起。
4.现在我们的代码知道每个元素所在的集合,现在来看mouseMove函数。mouseMove函数首先设置了一个变量target,表示鼠标下面的目标元素,如果这个元素在集合(用getAttribute判断)中就继续下面操作:
4.1.首先,在必要的时候,我们运行一个简单的脚本来改变目标元素的class属性,这样就创造了一个翻动的效果。
4.2.然后我们检查鼠标是否点击(因为我们的代码已经运行到这里),如果事件发生:
4.2.1.设置变量curTarget为当前元素。 4.2.2.记录元素当前在文档中的位置,以便在需要的时候可以将它的值取回。 4.2.3.将当前元素克隆到dragHelper,使得我们能够移动元素的隐藏备份。 4.2.4.因为在dragHelper中我们完全拥有了拖动元素的一个备份,这个元素会始终在鼠标下,我们必须移除dragObj属性,让代码知道dragObj已不在集合中。 4.2.5.我们快速记录集合中每个元素当前的位置、宽度和高度。当元素第一次开始被拖动时,我们仅需做一次这种工作,否则每当鼠标移动的时候我们都必须做一次,甚至一秒内几百次。
4.3.如果鼠标没有点击,要么我们和之前拥有同样的目标元素,要么没有目标元素,不论哪种情况我们都不会做任何事情。
5.现在我们检查curTarget变量。curTarget应该仅包含一个被拖动的对象,因此如果它存在,表示我们正在拖动一个元素:
5.1.移动隐藏DIV到鼠标,这个元素和文章前面所创建的元素一样能够被拖动。
5.2.然后我们检查鼠标是否存在于当前集合中每个容器中。
5.2.1.如果鼠标在某个容器中,我们检查容器中的每个元素,查看我们正拖动的元素属于哪个位置。 5.2.2.然后我们将所拖动的元素放置在容器中另一个元素的前面,或容器的最后位置。 5.2.3.最后我们确定元素可见。
6.剩下的事情就是捕获mouseUp事件: 6.1.首先需要隐藏dragHelper:它不再被需要,因为我们没有拖动任何东西。 6.2.如果拖动的元素是可见的,它已经存在于任何它所属的容器中,所有工作已完成。 6.3.如果拖动的元素不可见,我们将它放回它原来所在的地方。
//
iMouseDown represents the current mouse button state: up or down
/**/
/**/
/**/
/*
lMouseState represents the previous mouse button state so that we can check for button clicks and button releases:
if(iMouseDown && !lMouseState) // button just clicked! if(!iMouseDown && lMouseState) // button just released!
*/
var
mouseOffset
=
null
;
var
iMouseDown
=
false
;
var
lMouseState
=
false
;
var
dragObject
=
null
;
//
Demo 0 variables
var
DragDrops
=
[];
var
curTarget
=
null
;
var
lastTarget
=
null
;
var
dragHelper
=
null
;
var
tempDiv
=
null
;
var
rootParent
=
null
;
var
rootSibling
=
null
;
Number.prototype.NaN0
=
function
()
{
return
isNaN(
this
)
?
0
:
this
;}
function
CreateDragContainer()
{
/**/
/**/
/**/
/*
Create a new "Container Instance" so that items from one "Set" can not be dragged into items from another "Set"
*/
var
cDrag
=
DragDrops.length; DragDrops[cDrag]
=
[];
/**/
/**/
/**/
/*
Each item passed to this function should be a "container". Store each of these items in our current container
*/
for
(
var
i
=
0
; i
<
arguments.length; i
++
)
{
var
cObj
=
arguments[i]; DragDrops[cDrag].push(cObj); cObj.setAttribute('DropObj', cDrag);
/**/
/**/
/**/
/*
Every top level item in these containers should be draggable. Do this by setting the DragObj attribute on each item and then later checking this attribute in the mouseMove function
*/
for
(
var
j
=
0
; j
<
cObj.childNodes.length; j
++
)
{
//
Firefox puts in lots of #text nodesskip these
if
(cObj.childNodes[j].nodeName
==
'#text')
continue
;
cObj.childNodes[j].setAttribute('DragObj', cDrag); }
}
}
function
mouseMove(ev)
{ ev
=
ev
||
window.event;
/**/
/**/
/**/
/*
We are setting target to whatever item the mouse is currently on Firefox uses event.target here, MSIE uses event.srcElement
*/
var
target
=
ev.target
||
ev.srcElement;
var
mousePos
=
mouseCoords(ev);
//
mouseOut event - fires if the item the mouse is on has changed
if
(lastTarget
&&
(target
!==
lastTarget))
{
//
reset the classname for the target element
var
origClass
=
lastTarget.getAttribute('origClass');
if
(origClass) lastTarget.className
=
origClass; }
/**/
/**/
/**/
/*
dragObj is the grouping our item is in (set from the createDragContainer function). if the item is not in a grouping we ignore it since it can't be dragged with this script.
*/
var
dragObj
=
target.getAttribute('DragObj');
//
if the mouse was moved over an element that is draggable
if
(dragObj
!=
null
)
{
//
mouseOver event - Change the item's class if necessary
if
(target
!=
lastTarget)
{
var
oClass
=
target.getAttribute('overClass');
if
(oClass)
{ target.setAttribute('origClass', target.className); target.className
=
oClass; }
}
//
if the user is just starting to drag the element
if
(iMouseDown
&&
!
lMouseState)
{
//
mouseDown target
curTarget
=
target;
//
Record the mouse x and y offset for the element
rootParent
=
curTarget.parentNode; rootSibling
=
curTarget.nextSibling;
mouseOffset
=
getMouseOffset(target, ev);
//
We remove anything that is in our dragHelper DIV so we can put a new item in it.
for
(
var
i
=
0
; i
<
dragHelper.childNodes.length; i
++
) dragHelper.removeChild(dragHelper.childNodes[i]);
//
Make a copy of the current item and put it in our drag helper.
dragHelper.appendChild(curTarget.cloneNode(
true
)); dragHelper.style.display
=
'block';
//
set the class on our helper DIV if necessary
var
dragClass
=
curTarget.getAttribute('dragClass');
if
(dragClass)
{ dragHelper.firstChild.className
=
dragClass; }
//
disable dragging from our helper DIV (it's already being dragged)
dragHelper.firstChild.removeAttribute('DragObj');
/**/
/**/
/**/
/*
Record the current position of all drag/drop targets related to the element. We do this here so that we do not have to do it on the general mouse move event which fires when the mouse moves even 1 pixel. If we don't do this here the script would run much slower.
*/
var
dragConts
=
DragDrops[dragObj];
/**/
/**/
/**/
/*
first record the width/height of our drag item. Then hide it since it is going to (potentially) be moved out of its parent.
*/
curTarget.setAttribute('startWidth', parseInt(curTarget.offsetWidth)); curTarget.setAttribute('startHeight', parseInt(curTarget.offsetHeight)); curTarget.style.display
=
'none';
//
loop through each possible drop container
for
(
var
i
=
0
; i
<
dragConts.length; i
++
)
{
with
(dragConts[i])
{
var
pos
=
getPosition(dragConts[i]);
/**/
/**/
/**/
/*
save the width, height and position of each container.
Even though we are saving the width and height of each container back to the container this is much faster because we are saving the number and do not have to run through any calculations again. Also, offsetHeight and offsetWidth are both fairly slow. You would never normally notice any performance hit from these two functions but our code is going to be running hundreds of times each second so every little bit helps!
Note that the biggest performance gain here, by far, comes from not having to run through the getPosition function hundreds of times.
*/
setAttribute('startWidth', parseInt(offsetWidth)); setAttribute('startHeight', parseInt(offsetHeight)); setAttribute('startLeft', pos.x); setAttribute('startTop', pos.y); }
//
loop through each child element of each container
for
(
var
j
=
0
; j
<
dragConts[i].childNodes.length; j
++
)
{
with
(dragConts[i].childNodes[j])
{
if
((nodeName
==
'#text')
||
(dragConts[i].childNodes[j]
==
curTarget))
continue
;
var
pos
=
getPosition(dragConts[i].childNodes[j]);
//
save the width, height and position of each element
setAttribute('startWidth', parseInt(offsetWidth)); setAttribute('startHeight', parseInt(offsetHeight)); setAttribute('startLeft', pos.x); setAttribute('startTop', pos.y); }
}
}
}
}
//
If we get in here we are dragging something
if
(curTarget)
{
//
move our helper div to wherever the mouse is (adjusted by mouseOffset)
dragHelper.style.top
=
mousePos.y
-
mouseOffset.y; dragHelper.style.left
=
mousePos.x
-
mouseOffset.x;
var
dragConts
=
DragDrops[curTarget.getAttribute('DragObj')];
var
activeCont
=
null
;
var
xPos
=
mousePos.x
-
mouseOffset.x
+
(parseInt(curTarget.getAttribute('startWidth'))
/
2
);
var
yPos
=
mousePos.y
-
mouseOffset.y
+
(parseInt(curTarget.getAttribute('startHeight'))
/
2
);
//
check each drop container to see if our target object is "inside" the container
for
(
var
i
=
0
; i
<
dragConts.length; i
++
)
{
with
(dragConts[i])
{
if
(((getAttribute('startLeft'))
<
xPos)
&&
((getAttribute('startTop'))
<
yPos)
&&
((getAttribute('startLeft')
+
getAttribute('startWidth'))
>
xPos)
&&
((getAttribute('startTop')
+
getAttribute('startHeight'))
>
yPos))
{
/**/
/**/
/**/
/*
our target is inside of our container so save the container into the activeCont variable and then exit the loop since we no longer need to check the rest of the containers
*/
activeCont
=
dragConts[i];
//
exit the for loop
break
; }
}
}
//
Our target object is in one of our containers. Check to see where our div belongs
if
(activeCont)
{
//
beforeNode will hold the first node AFTER where our div belongs
var
beforeNode
=
null
;
//
loop through each child node (skipping text nodes).
for
(
var
i
=
activeCont.childNodes.length
-
1
; i
>=
0
; i
--
)
{
with
(activeCont.childNodes[i])
{
if
(nodeName
==
'#text')
continue
;
//
if the current item is "After" the item being dragged
if
( curTarget
!=
activeCont.childNodes[i]
&&
((getAttribute('startLeft')
+
getAttribute('startWidth'))
>
xPos)
&&
((getAttribute('startTop')
+
getAttribute('startHeight'))
>
yPos))
{ beforeNode
=
activeCont.childNodes[i]; }
}
}
//
the item being dragged belongs before another item
if
(beforeNode)
{
if
(beforeNode
!=
curTarget.nextSibling)
{ activeCont.insertBefore(curTarget, beforeNode); }
//
the item being dragged belongs at the end of the current container
}
else
{
if
((curTarget.nextSibling)
||
(curTarget.parentNode
!=
activeCont))
{ activeCont.appendChild(curTarget); }
}
//
make our drag item visible
if
(curTarget.style.display
!=
'')
{ curTarget.style.display
=
''; }
}
else
{
//
our drag item is not in a container, so hide it.
if
(curTarget.style.display
!=
'none')
{ curTarget.style.display
=
'none'; }
}
}
//
track the current mouse state so we can compare against it next time
lMouseState
=
iMouseDown;
//
mouseMove target
lastTarget
=
target;
//
track the current mouse state so we can compare against it next time
lMouseState
=
iMouseDown;
//
this helps prevent items on the page from being highlighted while dragging
return
false
; }
function
mouseUp(ev)
{
if
(curTarget)
{
//
hide our helper object - it is no longer needed
dragHelper.style.display
=
'none';
//
if the drag item is invisible put it back where it was before moving it
if
(curTarget.style.display
==
'none')
{
if
(rootSibling)
{ rootParent.insertBefore(curTarget, rootSibling); }
else
{ rootParent.appendChild(curTarget); }
}
//
make sure the drag item is visible
curTarget.style.display
=
''; }
curTarget
=
null
; iMouseDown
=
false
; }
function
mouseDown()
{ iMouseDown
=
true
;
if
(lastTarget)
{
return
false
; }
}
document.onmousemove
=
mouseMove; document.onmousedown
=
mouseDown; document.onmouseup
=
mouseUp;
window.onload
=
function
()
{
//
Create our helper object that will show the item while dragging
dragHelper
=
document.createElement('DIV'); dragHelper.style.cssText
=
'position:absolute;display:none;'; CreateDragContainer( document.getElementById('DragContainer1'), document.getElementById('DragContainer2'), document.getElementById('DragContainer3') );
document.body.appendChild(dragHelper); }
<!--
the mouse over and dragging class are defined on each item
-->
<
div
class
="DragContainer"
id
="DragContainer1"
>
<
div
class
="DragBox"
id
="Item1"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #1
</
div
>
<
div
class
="DragBox"
id
="Item2"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #2
</
div
>
<
div
class
="DragBox"
id
="Item3"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #3
</
div
>
<
div
class
="DragBox"
id
="Item4"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #4
</
div
>
</
div
>
<
div
class
="DragContainer"
id
="DragContainer2"
>
<
div
class
="DragBox"
id
="Item5"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #5
</
div
>
<
div
class
="DragBox"
id
="Item6"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #6
</
div
>
<
div
class
="DragBox"
id
="Item7"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #7
</
div
>
<
div
class
="DragBox"
id
="Item8"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #8
</
div
>
</
div
>
<
div
class
="DragContainer"
id
="DragContainer3"
>
<
div
class
="DragBox"
id
="Item9"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #9
</
div
>
<
div
class
="DragBox"
id
="Item10"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #10
</
div
>
<
div
class
="DragBox"
id
="Item11"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #11
</
div
>
<
div
class
="DragBox"
id
="Item12"
overClass
="OverDragBox"
dragClass
="DragDragBox"
>
Item #12
</
div
>
</
div
>
关于作者
Mark Kahn是一位Web Developer和DBA。可以通过这个网址跟他联系:
http://www.jslibrary.org
原文链接:
http://www.webreference.com/programming/javascript/mk/column2/3.html
另外两篇:
[翻译] 如何在 JavaScript 中实现拖放(上)
[翻译] 如何在 JavaScript 中实现拖放(中)
|