HTML5 的拖拽功能详细介绍
文章目录
本文主要介绍与拖拽操作相关的对象及事件信息,但并不涉及太多的源码演示。
一个简单的示例 在html5中要实现拖放操作,相对于以前通过鼠标操作实现,要简单得多,数据安全性也更有保障。只需要以下几步即可。
1.给被拖拽元素添加draggable属性,如果是文件拖放。 2.为目标元素添加一个dropzone属性,这一步也不是必须的,可以省略。 3.在拖拽元素的dragstart中初始化相关的数据信息,主要是DataTransfer对象。 4.在目标元素的dragover事件中,取消其默认操作。 5.在目标元素的drop事件中,处理接受到的数据。 6.在被拖拽元素的dragend事件中,做善后工作。若没有则可以省略。 大致代码如下:
01
<div id=
"source"
draggable=
"draggable"
>source</div>
02
<div id=
"target"
>target</div>
03
<script type=
"text/javascript"
>
04
var
target = document.getElementById(
'target'
);
05
var
source = document.getElementById(
'source'
);
06
source.ondragstart =
function
(e){
07
e.dataTransfer.effectAllowed =
'copyMove'
;
08
e.dataTransfer.setData(
'test'
,
'testData'
);
09
};
10
target.ondragover =
function
(e){
11
e.dataTransfer.dropEffect =
'move'
;
12
e.preventDefault();
// 不能少
13
};
14
target.ondrop =
function
(e){
15
var
elem = document.createElement(
'a'
);
16
elem.innerHTML = e.dataTransfer.getData(
'test'
);
17
e.target.appendChild(elem);
18
};
19
</script>
draggable属性 draggable是一个枚举属性,用于指定一个标签是否可以被拖拽。有以下四种取值:
1.true:表示此元素可拖拽。 2.false:表示此元素不可拖拽。 3.auto:除img和带href的标签a标签表示可拖拽外,其它标签均表示不可拖拽。 4.其它任何值:表示不可拖拽。 dropzone属性 这个属性用于接受拖拽元素的目标元素上,表示能接受的数据类型及操作方式。多个值用空格分开,不区分大小写。其值有以下类型组成:
•copy:表示将允许的元素放到该元素上时,会将拖拽数据复制到目标元素上。 •link:表示将允许的元素放到该元素上时,将链接数据到目标元素上。 •move:表示将允许的元素放到该元素上时,会将数据移动到目标元素上。 •以“string:”开头的字符串,长度不能小于8个字符:表示能接受DataTransferItem.kind值为“string”的data对象。 •以“file:”开头的字符串,长度不能小于6个字符:表示能接受DataTransferItem.kind值为“file”且DataTransferItem.type的值匹配“file:”之后的字符的DataTransferItem的对象。
相关的事件
DragEvent接口定义 DragEvent从MouseEvent接口继承,其定义如下,与MouseEvent相比,只是多了个DataTransfer对象。所有针对拖拽的操作也是通过控制此对象来完成的。
01
[Construct(DOMString type, optional DragEventInit eventInitDict)]
02
interface DragEvent : MouseEvent
03
{
04
readonly attribute DataTransfer? dataTransfer;
05
};
06
/* 这是用于初始事件的参数定义 */
07
dictionary DragEventInit : EventInit
08
{
09
// 从UIEvent继承的属性:
10
Window? view =
null
;
11
long detail = 0;
12
// 从MouseEvent继承的属性:
13
long screenX = 0;
14
long screenY = 0;
15
long clientX = 0;
16
long clientY = 0;
17
boolean ctrlKey =
false
;
18
boolean shiftKey =
false
;
19
boolean altKey =
false
;
20
boolean metaKey =
false
;
21
unsigned short button = 0;
22
unsigned short buttons = 0;
23
EventTarget? relatedTarget =
null
;
24
// DragEvent添加的新属性:
25
DataTransfer? dataTransfer;
26
}
事件描述
事件描述
拖拽相关事件 事件名称 事件目标 可撤消? 存储模式1 dropEffect值 默认操作 备注 1.存储模式是针对于
DataTransfer
对象的操作,具体数据见后表。 dragstart 被拖拽元素 是 读、写 none 初始化操作 若调用preventDefault()函数取消此事件的默认行为,则拖拽功能将被取消。 drag 被拖拽元素 是 保护模式 none 在dragstart之后,释放鼠标之前,不管鼠标是否移动,此事件不停地被触发。 dragenter 目标元素 是 保护模式 effectAllowed限定的值。 更换目标元素。 进入目标元素时,触发一次。 dragleave 离开前的目标元素 否 保护模式 none 离开时触发一次。 dragover 目标元素 是 保护模式 effectAllowed限定的值 重置dropEffect为none,并中断后续事件执行。 在dragenter之后,dragleave之前,不管是否移动,此事件都将不停地触发。 drop 目标元素 是 只读模式 当前设定的值 释放鼠后,由目标元素触发。 dragend 被拖拽元素 否 保护模式 当前设定的值 释放鼠标后,由被拖拽元素触发,顺序在drop之后。 目标元素是指当前鼠停留的元素,如要将A元素拖放到F元素上,中间经过的所有元素,在鼠标经过期间都是一个目标素,相应的事件都会被触发,A元素本身就是第一个目标元素。
DataTransfer接口 在HTML5中,为了实现在拖放过程中的数据交换,给所有的拖拽事件提供了一个DataTransfer属性。通过此对象的方法和属性来完善拖放功能。
01
interface DataTransfer
02
{
03
attribute DOMString dropEffect;
04
attribute DOMString effectAllowed;
05
void setDragImage(Element image, long x, long y);
06
readonly attribute DOMString[] types;
07
DOMString getData(DOMString format);
08
void setData(DOMString format, DOMString data);
09
void clearData(optional DOMString format);
10
readonly attribute DataTransferItemList items;
11
readonly attribute FileList files;
12
}
effectAllowed和dropEffect 这两个属性用于描述在拖拽过程中,鼠标显示的样式,受浏览器和操作系统的影响,鼠标显示的图标并不一致。
effectAllowed表示此次拖拽允许显示的鼠标样式,可以是以下值:“none”、“copy”、“copyLink”、“copyMove”、“link”、“linkMove”、“move”、“all”和“uninitialized”。只能在dragstart事件中更改此值。
dropEffect表示此次拖拽过程中显示的样式,可以是以下几个值:“copy”、“move”、“link”和“none”。在具体的拖拽过程中,还受effectAllowed值限定,具体限定内容见下表,当dropEffect的值被设置为一个不属于effectAllowed限定的值时,整个事件链将被中止,即后续事件都将不会被触发,但不会发生任何错误提示。
effectAllowed与dropEffect对照表 effectAllowed dropEffect 1:根据用户所使用的平台不同,可能会出现的值,如在windows下,copyMove的effectAllowed值,默认为copy操作,在按shift键时,则会变成move操作。 none none copy copy copyLink copy或是link1 copyMove copy或是move1 all copy、link1或是move1 link link linkMove link或是move1 move move uninitialized,被拖拽为一个文本框中选中的内容? move或是copy1,link1 uninitialized,被拖拽对象为一个普通选中项? copy或是link1,move1 uninitialized,被拖拽对象为一个带链接的a元素 link或是copy1,move1 其它情况 copy或是link1,move1 setDragImage(image, x, y) 这个函数用于设置鼠标移动过程中随鼠标一起移动的效果图,而不是鼠标指针的显示效果。x、y参数用于指定图像相对于鼠标指针的位置;image参数用于指定图像元素,若是一个img元素,则显示图像元素,否则将给定的元素转换成一张图像并显示。
该函数只能在读写模式(也就是dragstart事件)下有用,在其它事件中调用无效。若不调用此函数,则在拖拽时,被拖拽元素被转换成一个图处并当作一个效果图显示。
items属性 对items的接口定义如下:
01
interface DataTransferItemList
02
{
03
readonly attribute unsigned long length;
04
getter DataTransferItem(unsigned long index);
// items[index]
05
deleter void(unsigned long index);
// delete items[index]
06
void clear();
07
DataTransferItem? add(DOMString data, DOMString type);
08
DataTransferItem? add(File data);
09
}
10
interface DataTransferItem
11
{
12
readonly attribute DOMString kind;
13
readonly attribute DOMString type;
14
void getAsString(FunctionStringCallback? _callback);
15
File? getAsFile();
16
}
17
[Callback, NoInterfaceObject]
18
interface FunctionStringCallback
19
{
20
void handleEvent(DOMString data);
21
}
从上面的定义不难看出:DataTransfer.items就是DataTransferItem的一个数组。DataTransferItemList仅仅是定义一套以数组形式存取DataTransferItem对象的接口。我们主要看一下DataTransferItem类的定义:
•kind:表示数据的类型,只能是string或File。单从字面就很好理解这两个值代表的是什么意思。 •type:实际数据的类型或是格式,一般用mimetype表示,但并不是强制mimetype格式。 •getAsString(callback):当kind属性为string时,在只读或是读写模式下,可以通过回调函数处理此对象关联的实际数据。 •getAsFile():当kind为file是,通过此函数能获取真实的数据,否则返回null,只在只读或是读写模式下有效。 在非读写模式下删除DataTransferItemList中的数据,会返回InvalidStateError错误。若是在非读写模式下添加数据,则不执行任何操作。DataTransfer.setData则是对这两个函数的封装(根据第二个参数决定是删除还是添加)。
types属性 返回根据下列步骤产生的字符串集合(DOMStringList):
1.产生一个空的DOMStringList对象L。 2.遍历DataTransfer.items对象。 3.若DataTransfer.items的子项的kind的值为“string”,则将该项的type值添加到L对象中。 4.若DataTransfer.items的子项的kind的值为“file”,则向L对象添加"Files"字符串。 5.返回L对象 getData(format) getData是从DataTransfer.items中查找数据。返回符合以下条件的数据:
1.DataTransferItem.kind为“string” 2.DataTransferItem.type的值等于format参数 如果没有找到匹配的或是处于保护模式下,则返回一个空字符串。
参数format在传递到函数内部之前,都会被转换成小写字符,且如果参数值为“text”或是“url”,则会被转换成“text/plain”和“text/uri-list”。
setData(format, data) setData用于向DataTransfer.items中添加或删除一条数据:
当没有指定第二个参数data时,则是从DataTransfer.items中删除符合以下条件的数据:
1.kind等于“string” 2.type等于参数format 当指定第二个参数data时,则是向DataTransfer.items中添加数据,新添加的数据格式如下:
1.kind的值为“string” 2.type的值为format 3.data参数作为DataTransferItem的实际值。 参数format在传递到函数内部之前,都会被转换成小写字符,且如果参数值为“text”或是“url”,则会被转换成“text/plain”和“text/uri-list”。
如果不处于读写模式下,则不做任何操作。
clearData() 清除所有kind值为“string”的项。只在读写模式下起作用。
存储模式 存储模式决定了DataTransfer各项内容是否可用。下表列出相关的信息,其中“Y”表示可用,“N”表示不可用。
存储模式与
DataTransfer
各项的关系 读写只读保护dropEffect只在
dragenter
与
dragover
事件中可更改,其它事件中只可读取。effectAllowed只在
dragstart
事件中起作用items对items的操作详细情况参考后面的
setData
函数types仅在
dragenter
、
dragover
与
drop
三个事件中可获取此值setDataYNNgetDataYYNclearDataYNNDataTransferItem.getAsStringYYNDataTransferItem.getAsFileYYN
转载于猿2048:➩《HTML5 的拖拽功能详细介绍》
评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论