drag 事件在用户拖动元素或选择的文本时,每隔几百毫秒就会被触发一次。
语法
在类似 EventTarget.addEventListener 这样的方法中使用事件名称,或设置事件处理器属性。
addEventListener("drag", (event) => {});
ondrag = (event) => {};
事件类型
一个 DragEvent。继承自 Event。
DragEvent
事件属性
除了下面列出的属性外,还可以使用父接口 Event 的属性。
- DragEvent.dataTransfer
- : 在进行拖放操作时,传输的数据。
示例
拖放示例
HTML
<div class="dropzone">
<div id="draggable" draggable="true">这个 div 可以拖动</div>
</div>
<div class="dropzone" id="droptarget"></div>
CSS
body {
/* Prevent the user selecting text in the example */
user-select: none;
}
#draggable {
text-align: center;
background: white;
}
.dropzone {
width: 200px;
height: 20px;
background: blueviolet;
margin: 10px;
padding: 10px;
}
.dropzone.dragover {
background-color: purple;
}
.dragging {
opacity: 0.5;
}
JavaScript
let dragged;
/* 在可拖动的目标上触发的事件 */
const source = document.getElementById("draggable");
source.addEventListener("drag", (event) => {
console.log("dragging");
});
source.addEventListener("dragstart", (event) => {
// 保存被拖动元素的引用
dragged = event.target;
// 设置为半透明
event.target.classList.add("dragging");
});
source.addEventListener("dragend", (event) => {
// 拖动结束,重置透明度
event.target.classList.remove("dragging");
});
/* 在放置目标上触发的事件 */
const target = document.getElementById("droptarget");
target.addEventListener(
"dragover",
(event) => {
// 阻止默认行为以允许放置
event.preventDefault();
},
false,
);
target.addEventListener("dragenter", (event) => {
// 在可拖动元素进入潜在的放置目标时高亮显示该目标
if (event.target.classList.contains("dropzone")) {
event.target.classList.add("dragover");
}
});
target.addEventListener("dragleave", (event) => {
// 在可拖动元素离开潜在放置目标元素时重置该目标的背景
if (event.target.classList.contains("dropzone")) {
event.target.classList.remove("dragover");
}
});
target.addEventListener("drop", (event) => {
// 阻止默认行为(会作为某些元素的链接打开)
event.preventDefault();
// 将被拖动元素移动到选定的目标元素中
if (event.target.classList.contains("dropzone")) {
event.target.classList.remove("dragover");
dragged.parentNode.removeChild(dragged);
event.target.appendChild(dragged);
}
});
结果
拖放示例
规范
浏览器兼容性
参见
-
其他拖放事件:
- HTMLElement/dragstart_event
- HTMLElement/dragend_event
- HTMLElement/dragover_event
- HTMLElement/dragenter_event
- HTMLElement/dragleave_event
- HTMLElement/drop_event
-
其他目标上的此事件:
- Window:Window/drag_event 事件
- Document:Document/drag_event 事件
- SVGElement:SVGElement/drag_event 事件
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
