ondragСобытие

事件对象参考手册Объект Event

Пример

Выполните JavaScript, когда элемент <p> начинают перетаскивать:

<p draggable="true" ondrag="myFunction(event)">Перетащи меня!</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:

<element ondrag="myScript">Попробуйте сами

В JavaScript:

object.ondrag=function(){myScript};Попробуйте сами

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

object.addEventListener("drag", myScript);Попробуйте сами

Примечание:Internet Explorer 8 и более ранние версии IE не поддерживают методaddEventListener().


Технические детали
Всплывает: Да
Отменяемое: Да
Тип события: DragEvent
Поддерживаемые HTML-теги: Все элементы HTML


Examples

Другие примеры

Пример

В следующем примере демонстрируются все события перетаскивания:

/* Возникает при перетаскивании */
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


事件对象参考手册Объект события Другие расширения