Событие ondrag

События DOM DragEvent

Определение и использование

Событие ondrag происходит при перетаскивании элемента или выбора текста.

Перетаскивание - это очень распространенная функция в HTML5. Это когда вы "хватываете" объект и перетаскиваете его в другое место. Чтобы узнать больше, читайте наши статьи о Перетаскивание HTML5HTML учебник.

Комментарий:Чтобы сделать элемент перетаскиваемым, используйте глобальное Свойство draggable HTML5。

Совет:По умолчанию, ссылки и изображения перетаскиваются, не требуя свойства draggable.

В различных этапах операции перетаскивания и放下 используются множество событий и может произойти:

События, запускаемые на источнике перетаскивания (элементе-источнике):

  • ondragstart - Когда пользователь начинает перетаскивать элемент, происходит
  • ondrag - Когда элемент перетаскивается, происходит
  • ondragend - Когда пользователь завершает перетаскивание элемента, происходит

События, запускаемые на целевой точке размещения:

  • ondragenter - Когда перетаскиваемый элемент входит в целевую точку размещения, происходит
  • ondragover - Когда перетаскиваемый элемент находится на целевой точке размещения, происходит
  • ondragleave - Когда перетаскиваемый элемент удаляется от целевой точки размещения, происходит
  • ondrop - Когда перетаскиваемый элемент помещается на целевую точку размещения, происходит

Комментарий:При перетаскивании элемента событие ondrag запускается каждые 350 миллисекунд.

Пример

При перетаскивании элемента <p> выполняется JavaScript:

<p draggable="true" ondrag="myFunction(event)">Перетащите меня!</p>

Попробуйте сами

На странице внизу есть больше примеров TIY.

Грамматика

В HTML:

<элемент ondrag="myScript">

Попробуйте сами

В JavaScript:

объект.ondrag = function(){myScript};

Попробуйте сами

В JavaScript, использование метода addEventListener():

объект.addEventListener("drag", myScript);

Попробуйте сами

Комментарий:Internet Explorer 8 или более ранние версии не поддерживаются addEventListener() 方法。

技术细节

冒泡： 支持
可取消： 支持
事件类型： DragEvent
支持的 HTML 标签： 所有 HTML 元素
DOM 版本： Level 3 Events

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

事件 Chrome IE Firefox Safari Opera
ondrag 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";
});
/* ----------------- События, вызываемые на目标是 места для размещения ----------------- */
// При входе в 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();
});
// При выходе из droptarget, сбросить стиль рамки DIV
document.addEventListener("dragleave", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "";
  }
});
/* При выпадении - предотвратить стандартную обработку данных браузером (по умолчанию данные открываются как ссылка)
Сбросить цвет текста и цвет рамки DIV
Получить данные перемещения с помощью метода dataTransfer.getData()
Перемещаемые данные это идентификатор перемещаемого элемента ("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:Атрибут draggable HTML

События DOM DragEvent