ondragenter-händelse
Definition och användning
När en draggable element eller textmarkering kommer in i ett giltigt mål inträffar ondragenter-händelsen.
ondragenter och ondragleave-händelser hjälper användaren att förstå när en draggable element är på väg att komma in eller lämnar målet. Till exempel kan du sätta en bakgrundsfärg när elementet kommer in i målet och ta bort färgen när elementet lämnar målet.
Drag-and-drop är en mycket vanlig funktion i HTML5. Det innebär att du "fångar" ett objekt och drar det till en annan plats. För att lära dig mer, läs vår artikel om HTML5 drag-and-dropHTML-tutorials.
Anmärkning:För att göra element draggbara, använd global HTML5 draggable-attribut。
Tips:Som standard är länkar och bilder draggbara utan att behöva draggable-attribut.
Under olika faser av drag-and-drop-operationer används många händelser och kan inträffa:
Händelser som utlösas på en draggable mål (källor):
- ondragstart - När användaren börjar dra elementet inträffar
- ondrag - När elementet dras inträffar
- ondragend - När användaren slutför att dra elementet inträffar
Händelser som utlösas på målet:
- ondragenter - När den draggbara elementen kommer in i målet inträffar
- ondragover - När den draggbara elementen finns på målet inträffar
- ondragleave - När den draggbara elementen lämnar målet inträffar
- ondrop - När den draggbara elementen placeras på målet inträffar
Exempel
Kör JavaScript när en draggable element kommer in i målet:
<div ondragenter="myFunction(event)"></div>
Mer TIY-exempel finns längre ner på sidan.
Syntaks
I HTML:
<element ondragenter="myScript">
I JavaScript:
object.ondragenter = function(){myScript};
I JavaScript, använda addEventListener() metoden:
object.addEventListener("dragenter", myScript);
Anmärkning:Internet Explorer 8 eller tidigare versioner stöder inte addEventListener() 方法。
技术细节
| 冒泡： | 支持 |
|---|---|
| 可取消： | 支持 |
| 事件类型： | DragEvent |
| 支持的 HTML 标签： | 所有 HTML 元素 |
| DOM 版本： | Level 3 Events |
浏览器支持
表中的数字注明了完全支持该事件的首个浏览器版本。
| 事件 | Chrome | IE | Firefox | Safari | Opera |
|---|---|---|---|---|---|
| ondragenter | 4.0 | 9.0 | 3.5 | 6.0 | 12.0 |
更多实例
对所有可能的拖放事件的演示：
<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 时，改变 DIV 的边框样式
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 时，重置 DIV 的边框样式
document.addEventListener("dragleave", function(event) {
if ( event.target.className == "droptarget" ) {
event.target.style.border = "";
}
});
/* 防止浏览器对数据的默认处理（默认放置时以链接打开）
重置输出文本的颜色和 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>
