html5拖动文档,HTML5 拖放

HTML5 拖放

拖放(DnD)是一个强大的用户界面相关的概念，借助鼠标点击的帮助，它让复制，重新排序以及删除条目变得很容易。这就允许用户在某个元素上点击并按住鼠标按键，把它拖到另外一个位置，然后释放鼠标按键把与元素放到该位置。

要使用传统的 HTML4 实现拖放的功能，开发者要么使用复杂的 JavaScript 变成，要么使用 JavaScript 框架，比如 jQuery 等等。

现在 HTML5 提出了拖放(DnD)API，为浏览器带来了原生拖放支持，让编码变得更容易。

所有的主流浏览器比如 Chrome，FireFox 3.5 以及 Safari 4 等等都支持 HTML5 拖放。

Drag 和 Drop 事件

下面列出了一些在执行拖放操作各个阶段会触发的事件：

事件

描述

dragstart

用户开始拖动对象时触发。

dragenter

鼠标初次移到目标元素并且正在进行拖动时触发。这个事件的监听器应该之指出这个位置是否允许放置元素。如果没有监听器或者监听器不执行任何操作，默认情况下不允许放置。

dragover

拖动时鼠标移到某个元素上的时候触发。大多数时候，监听器触发的操作与 dragenter 事件相同。

dragleave

拖动时鼠标离开某个元素的时候触发。监听器应该移除用于放置反馈的高粱或插入标记。

drag

对象被拖拽时每次鼠标移动都会触发。

drop

拖动操作结束，放置元素时触发。监听器负责检索被拖动的数据以及在放置位置插入它。

dragend

拖动对象时用户释放鼠标按键的时候触发。

注意：只会触发拖动事件；拖动操作期间鼠标事件，比如 mousemove 并不会触发。

DataTransfer 对象

所有 drag 和 drop 事件的事件监听器都接收一个 Event 对象作为参数，它有一个叫做 dataTransfer 的只读属性。event.dataTransfer 返回与事件相关的 DataTransfer 对象，如下所示：

function EnterHandler(event) {

DataTransfer dt = event.dataTransfer;

.............

}

DataTransfer 对象持有 drag 和 drop 操作相关的数据。可以检索这些数据以及设置 DataTransfer 对象相关联的各种属性，正如下面所阐述的：

S.N.

DataTransfer 属性及其描述

1

dataTransfer.dropEffect [ = value ]

返回当前选中的操作类型。

这个属性也可以设置改变当前选中的操作。

可选值为none，copy，link和move。

2

dataTransfer.effectAllowed [ = value ]

返回允许的操作类型。

这个属性也可以设置改变允许的操作。

可选值为none，copy，copyLink，copyMove，link，linkMove，move，all和uninitialized。

3

dataTransfer.types

返回列出设置给 dragstart 事件格式的 DOMStringList。此外，如果任意文件被拖拽，那么其中一个类型将会是字符串“Files"。

4

dataTransfer.clearData( [ format ] )

移除指定格式的数据。如果省略参数则移除所有数据。

5

dataTransfer.setData(format, data)

添加给定的数据。

6

data = dataTransfer.getData(format)

返回指定的数据。如果没有该数据则返回空字符串。

7

dataTransfer.files

如果有，返回表示被拖拽文件的 FileList。

8

dataTransfer.setDragImage(element, x, y)

使用给定的元素更新拖拽反馈信息，替换先前指定的反馈信息。

9

dataTransfer.addElement(element)

把给定的元素添加到用来渲染拖拽反馈的元素列表。

Drag 和 Drop 过程

下面是实现拖拽操作的步骤：

步骤1：创建一个可拖拽对象

下面是要采用的步骤：

如果想要拖动某个元素，需要设置元素的 draggable 属性为 true。

给 dragstart 设置一个事件监听器存储拖拽数据。

事件监听器 dragstart 会设置允许的效果(copy，move，link或者是组合形式的)。

下面是一个让对象可拖拽的示例：

#boxA, #boxB {

float:left;padding:10px;margin:10px; -moz-user-select:none;

}

#boxA { background-color: #6633FF; width:75px; height:75px; }

#boxB { background-color: #FF6699; width:150px; height:150px; }

function dragStart(ev) {

ev.dataTransfer.effectAllowed='move';

ev.dataTransfer.setData("Text", ev.target.getAttribute('id'));

ev.dataTransfer.setDragImage(ev.target,0,0);

return true;

}

Drag and drop HTML5 demo

Try to drag the purple box around.

οndragstart="return dragStart(event)">

Drag Me

Dustbin

便于学习上述概念 - 请使用最新版的 FireFox，Safari 或 Chrome 进行在线练习。

步骤2：放置对象

为了接受放置，放置目标至少要监听三个事件。

dragenter 事件，用来确定放置目标是否接受放置。如果放置被接受，那么这个事件必须取消。

dragover 事件，用来确定给用户显示怎样的反馈信息。如果这个事件被取消，反馈信息(通常就是光标)就会基于 dropEffect 属性的值更新。

最后是 drop 事件，允许执行真是的放置。

下面是把一个对象放入另一个对象的示例：

#boxA, #boxB {

float:left;padding:10px;margin:10px;-moz-user-select:none;

}

#boxA { background-color: #6633FF; width:75px; height:75px; }

#boxB { background-color: #FF6699; width:150px; height:150px; }

function dragStart(ev) {

ev.dataTransfer.effectAllowed='move';

ev.dataTransfer.setData("Text", ev.target.getAttribute('id'));

ev.dataTransfer.setDragImage(ev.target,0,0);

return true;

}

function dragEnter(ev) {

event.preventDefault();

return true;

}

function dragOver(ev) {

return false;

}

function dragDrop(ev) {

var src = ev.dataTransfer.getData("Text");

ev.target.appendChild(document.getElementById(src));

ev.stopPropagation();

return false;

}

Drag and drop HTML5 demo

Try to move the purple box into the pink box.

οndragstart="return dragStart(event)">

Drag Me

οndrοp="return dragDrop(event)"

οndragοver="return dragOver(event)">Dustbin

便于学习上述概念 - 请使用最新版的 FireFox，Safari 或 Chrome 进行在线练习。