ondragenterСобытие

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

Примеры

Выполнять JavaScript, когда перетаскиваемый элемент входит в цель сброса:

<div ondragenter="myFunction(event)"></div>

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

Дополнительные примеры приведены в нижней части этой статьи.


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

Событие ondragenter срабатывает, когда перетаскиваемый элемент или выделенный текст входит в допустимую цель сброса.

События ondragenter и ondragleave могут помочь пользователям лучше понять процесс входа и выхода перетаскиваемого элемента из области сброса. Можно задавать разные цвета фона, когда перетаскиваемый элемент входит в область сброса и покидает её.

Перетаскивание — очень распространённая возможность в HTML5. Для получения дополнительной информации см. наш учебник по HTML в разделе«Перетаскивание в HTML5»。

Примечание:Чтобы сделать элемент перетаскиваемым, используйте атрибут HTML5draggable.

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

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

  • События, возникающие в источнике перетаскивания(исходный элемент):
    • ondragstart- Срабатывает, когда пользователь начинает перетаскивать элемент
    • ondrag- Срабатывает, когда элемент перетаскивается
    • ondragend- Срабатывает, когда пользователь завершает перетаскивание элемента

  • События, возникающие на цели перетаскивания:
    • ondragenter - Это событие срабатывает, когда объект, перетаскиваемый мышью, входит в диапазон своего контейнера
    • ondragover- Это событие срабатывает, когда перетаскиваемый объект перетаскивается в пределах диапазона контейнера другого объекта
    • ondragleave- Это событие срабатывает, когда объект, перетаскиваемый мышью, покидает диапазон своего контейнера
    • ondrop- это событие срабатывает, когда кнопка мыши отпускается во время операции перетаскивания

Поддержка браузеров

Числа в таблице указывают первую версию браузера, которая полностью поддерживает это событие.

Event
ondragenter 4.0 9.0 3.5 6.0 12.0


Синтаксис

В HTML:

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

В JavaScript:

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

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

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

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


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


Examples

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

Пример

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

/* при перетаскивании */
document.addEventListener("dragstart", function(event) {
//Метод dataTransfer.set() задаёт тип данных и перетаскиваемые данные
    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";
    }
});
// По умолчанию данные/элементы нельзя сбросить в другие элементы. Для drop необходимо предотвратить стандартную обработку элемента
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(), чтобы получить перетаскиваемые данные
Идентификатор перетаскиваемого элемента данных ("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:HTML-атрибут draggable


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