ondragstart 事件
实例
当用户开始拖动 <p> 元素时执行 JavaScript:
<p draggable="true" ondragstart="myFunction(event)">Drag me!</p>
亲自试一试 »
页面下方有更多实例。
定义和用法
ondragstart 事件在用户开始拖动元素或文本选择时发生。
拖放是 HTML5 中非常常见的功能。就是当您"抓取"一个对象并将其拖动到不同位置时。如需学习更多知识,请阅读我们关于 HTML5 拖放的 HTML 教程。
注释:如需使元素可拖动,请使用全局 HTML5 draggable 属性。
提示:默认情况下,链接和图像是可拖动的,不需要 draggable 属性。
在拖放操作的不同阶段,有许多事件被使用,并且可能发生:
在可拖动目标(源元素)上触发的事件:
- ondragstart - 当用户开始拖动元素时发生
- ondrag - 当元素被拖动时发生
- ondragend - 当用户完成拖动元素时发生
在放置目标上触发的事件:
- ondragenter - 当被拖动的元素进入放置目标时发生
- ondragover - 当被拖动的元素在放置目标上时发生
- ondragleave - 当被拖动的元素离开放置目标时发生
- ondrop - 当被拖动的元素被放在放置目标上时发生
浏览器支持
表中的数字表示支持该事件的第一个浏览器版本。
事件 | |||||
---|---|---|---|---|---|
ondragstart | 4.0 | 9.0 | 3.5 | 6.0 | 12.0 |
语法
注释:Internet Explorer 8 或更早的版本不支持 addEventListener() 方法。
技术细节
是否支持冒泡: | Yes |
---|---|
是否支持取消: | Yes |
事件类型: | DragEvent |
支持的 HTML 标签: | 所有 HTML 元素 |
DOM 版本: | Level 3 Events |
更多实例
实例
对所有可能的拖放事件的演示:
<p draggable="true" id="dragtarget">Drag me!</p>
<div class="droptarget">Drop here!</div>
<script>
/* ----------------- 在拖动目标上触发的事件 ----------------- */
document.addEventListener("dragstart", function(event) {
// dataTransfer.setData() 方法设置拖拽数据的数据类型和值
event.dataTransfer.setData("Text", event.target.id);
// 开始拖动p元素时输出一些文本
document.getElementById("demo").innerHTML = "Started to drag the p element.";
// 更改可拖动元素的不透明度
event.target.style.opacity = "0.4";
});
// 拖动 p 元素时,更改输出文本的颜色
document.addEventListener("drag", function(event) {
document.getElementById("demo").style.color = "red";
});
// 完成拖动 p 元素并重置不透明度后输出一些文本
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "Finished dragging the p element.";
event.target.style.opacity = "1";
});
/* ----------------- 在放置目标上触发的事件 ----------------- */
// 当可拖动p元素进入droptarget时,改变DIVS的边框样式
document.addEventListener("dragenter", function(event) {
if ( event.target.className == "droptarget" ) {
event.target.style.border = "3px dotted red";
}
});
// 默认情况下,数据/元素不能放在其他元素中。 为了允许放置,我们必须防止元素的默认处理
document.addEventListener("dragover", function(event) {
event.preventDefault();
});
// 当可拖动的 p 元素离开 droptarget 时,重置 DIVS 的边框样式
document.addEventListener("dragleave", function(event) {
if ( event.target.className == "droptarget" ) {
event.target.style.border = "";
}
});
/* On drop - 防止浏览器默认处理数据(默认在放置时作为链接打开)
重置输出文本的颜色和 DIV 的边框颜色
使用 dataTransfer.getData() 方法获取拖动的数据
拖拽数据是被拖拽元素的id ("drag1")
将拖拽元素追加到放置元素中
*/
document.addEventListener("drop", function(event) {
event.preventDefault();
if ( event.target.className == "droptarget" ) {
document.getElementById("demo").style.color = "";
event.target.style.border = "";
var data = event.dataTransfer.getData("Text");
event.target.appendChild(document.getElementById(data));
}
});
</script>
亲自试一试 »
<div class="droptarget">Drop here!</div>
<script>
/* ----------------- 在拖动目标上触发的事件 ----------------- */
document.addEventListener("dragstart", function(event) {
// dataTransfer.setData() 方法设置拖拽数据的数据类型和值
event.dataTransfer.setData("Text", event.target.id);
// 开始拖动p元素时输出一些文本
document.getElementById("demo").innerHTML = "Started to drag the p element.";
// 更改可拖动元素的不透明度
event.target.style.opacity = "0.4";
});
// 拖动 p 元素时,更改输出文本的颜色
document.addEventListener("drag", function(event) {
document.getElementById("demo").style.color = "red";
});
// 完成拖动 p 元素并重置不透明度后输出一些文本
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "Finished dragging the p element.";
event.target.style.opacity = "1";
});
/* ----------------- 在放置目标上触发的事件 ----------------- */
// 当可拖动p元素进入droptarget时,改变DIVS的边框样式
document.addEventListener("dragenter", function(event) {
if ( event.target.className == "droptarget" ) {
event.target.style.border = "3px dotted red";
}
});
// 默认情况下,数据/元素不能放在其他元素中。 为了允许放置,我们必须防止元素的默认处理
document.addEventListener("dragover", function(event) {
event.preventDefault();
});
// 当可拖动的 p 元素离开 droptarget 时,重置 DIVS 的边框样式
document.addEventListener("dragleave", function(event) {
if ( event.target.className == "droptarget" ) {
event.target.style.border = "";
}
});
/* On drop - 防止浏览器默认处理数据(默认在放置时作为链接打开)
重置输出文本的颜色和 DIV 的边框颜色
使用 dataTransfer.getData() 方法获取拖动的数据
拖拽数据是被拖拽元素的id ("drag1")
将拖拽元素追加到放置元素中
*/
document.addEventListener("drop", function(event) {
event.preventDefault();
if ( event.target.className == "droptarget" ) {
document.getElementById("demo").style.color = "";
event.target.style.border = "";
var data = event.dataTransfer.getData("Text");
event.target.appendChild(document.getElementById(data));
}
});
</script>
相关页面
HTML 教程: HTML5 拖放
HTML 参考手册: HTML draggable 属性