ondragСобытие
Пример
Выполните JavaScript, когда элемент <p> начинают перетаскивать:
Попробуйте сами »
Дополнительные примеры приведены в нижней части этой статьи.
Определение и использование
Событие ondrag срабатывает, когда перетаскивается элемент или выделенный текст.
Перетаскивание — очень распространённая возможность в HTML5. Для получения дополнительной информации см. наш учебник по HTML в разделе«Перетаскивание в HTML5»。
Примечание:Чтобы сделать элемент перетаскиваемым, необходимо использовать атрибут HTML5draggable.
Совет:Ссылки и изображения перетаскиваются по умолчанию и не нуждаются в атрибуте draggable.
Во время процесса перетаскивания запускаются следующие события:
-
События, возникающие на цели перетаскивания(исходный элемент):
- ondragstart- Срабатывает, когда пользователь начинает перетаскивать элемент
- ondrag - Срабатывает, пока элемент перетаскивается
- ondragend- Срабатывает после того, как пользователь завершит перетаскивание элемента
-
События, возникающие на цели перетаскивания:
- ondragenter- Это событие возникает, когда перетаскиваемый объект входит в область своего контейнера
- ondragover- Это событие возникает, когда перетаскиваемый объект перетаскивается в пределах области контейнера другого объекта
- ondragleave- Это событие возникает, когда перетаскиваемый объект покидает область своего контейнера
- ondrop- Это событие возникает, когда кнопка мыши отпускается во время перетаскивания
Примечание:Событие ondrag возникает каждые 350 миллисекунд, пока элемент перетаскивается.
Поддержка браузеров
Числа в таблице указывают первую версию браузера, которая полностью поддерживает это событие.
| Event | |||||
|---|---|---|---|---|---|
| ondrag | 4.0 | 9.0 | 3.5 | 6.0 | 12.0 |
Синтаксис
В HTML:
В JavaScript:
В JavaScript с использованием метода addEventListener():
Примечание:Internet Explorer 8 и более ранние версии IE не поддерживают методaddEventListener().
Технические детали
| Всплывает: | Да |
|---|---|
| Отменяемое: | Да |
| Тип события: | DragEvent |
| Поддерживаемые HTML-теги: | Все элементы HTML |

Другие примеры
Пример
В следующем примере демонстрируются все события перетаскивания:
document.addEventListener("dragstart", function(event) {
// Метод dataTransfer.setData() задает тип данных и перетаскиваемые данные
event.dataTransfer.setData("Text", event.target.id);
// Вывести текст, когда элемент p перетаскивается
document.getElementById("demo").innerHTML = "Начните перетаскивать элемент p.";
// Изменить непрозрачность перетаскиваемого элемента
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 = "Перетаскивание элемента p завершено";
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 = "";
}
});
/* Для drop предотвратите стандартную обработку данных браузером (по умолчанию ссылки открываются при drop)
Сбросьте цвет текста вывода и цвет границы DIV
Используйте метод dataTransfer.getData(), чтобы получить перетаскиваемые данные
Идентификатор перетаскиваемого элемента данных — id("drag1")
Добавьте перетаскиваемый элемент в элемент drop*/
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));
}
});
Попробуйте сами »
Связанные страницы
Учебник по HTML:HTML5 Перетаскивание
Справочник по HTML:Атрибут draggable в HTML
Объект события Другие расширения