ondragoverEvento

事件对象参考手册Objeto de evento

Ejemplo

Se activa cuando un elemento se arrastra sobre un objetivo de colocación:

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

Pruébalo »

Este artículo contiene más ejemplos al final.


Definición y uso

El evento ondragover se activa cuando un elemento arrastrable o texto seleccionado se arrastra sobre un objetivo de colocación.

De forma predeterminada, los datos/elementos no se pueden soltar en otros elementos. Para implementar esta función, debemos evitar el método de manejo predeterminado del elemento. Podemos lograrlo llamando al método event.preventDefault() para el evento ondragover.

Arrastrar y soltar es una función muy común en HTML5. Para más información, consulta en nuestro tutorial de HTML:Arrastrar y soltar en HTML5。

Nota:Para que un elemento sea arrastrable, se necesita eldraggableatributo HTML5.

Consejo:Los enlaces y las imágenes son arrastrables por defecto, no necesitan el atributo draggable.

Durante el proceso de arrastrar y soltar se activan los siguientes eventos:

  • Eventos que se activan en el objetivo de arrastre(elemento de origen):
    • ondragstart- Se activa cuando el usuario comienza a arrastrar el elemento
    • ondrag- Se activa mientras el elemento se está arrastrando
    • ondragend- Se activa cuando el usuario termina de arrastrar el elemento

  • Eventos que se activan en el objetivo de colocación:
    • ondragenter- Este evento se activa cuando el objeto arrastrado con el ratón entra en el área de su contenedor
    • ondragover: este evento se activa cuando un objeto arrastrado se mueve dentro del área del contenedor de otro objeto
    • ondragleave- Este evento se activa cuando el objeto arrastrado con el ratón sale del área de su contenedor
    • ondrop- Este evento se activa al soltar el botón del ratón durante un arrastre

Nota:Al arrastrar un elemento, el evento ondragover se activa cada 350 milisegundos.


Compatibilidad del navegador

Los números de la tabla indican la versión del primer navegador compatible con el evento.

Evento
ondragover 4.0 9.0 3.5 6.0 12.0


Sintaxis

En HTML:

<element ondragover="myScript">Pruébalo

En JavaScript:

object.ondragover=function(){myScript};Pruébalo

En JavaScript, usando el método addEventListener():

object.addEventListener("dragover", myScript);Pruébalo

Nota:Internet Explorer 8 y versiones anteriores de IE no son compatibles con eladdEventListener()método.


Detalles técnicos
¿Admite burbujeo (bubbling)? Yes
¿Se puede cancelar? Yes
Tipo de evento: DragEvent
Etiquetas HTML compatibles: All HTML elements


Examples

Más ejemplos

Ejemplo

El siguiente ejemplo demuestra todos los eventos de arrastrar y soltar:

/* Se activa al arrastrar */
document.addEventListener("dragstart", function(event) {
// El método dataTransfer.setData() establece el tipo de dato y el dato arrastrado
    event.dataTransfer.setData("Text", event.target.id);
// Muestra algo de texto al arrastrar el elemento p
document.getElementById("demo").innerHTML = "Empieza a arrastrar el elemento p.";
// Cambia la opacidad del elemento arrastrado
    event.target.style.opacity = "0.4";
});
// Mientras se arrastra el elemento p, cambia el color del texto de salida
document.addEventListener("drag", function(event) {
    document.getElementById("demo").style.color = "red";
});
// Al terminar de arrastrar el elemento p, muestra texto y restablece la opacidad
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "Se completó el arrastre del elemento p";
    event.target.style.opacity = "1";
});
/* Se activa al completar el arrastre */
// Cuando el elemento p termina de arrastrarse y entra en el droptarget, cambia el estilo del borde del div
document.addEventListener("dragenter", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "3px dotted red";
    }
});
// De forma predeterminada, los datos/elementos no se pueden soltar en otros elementos. Para drop debemos evitar el manejo predeterminado del elemento
document.addEventListener("dragover", function(event) {
    event.preventDefault();
});
// Cuando el elemento p arrastrable sale del droptarget, restablece el estilo del borde del div
document.addEventListener("dragleave", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "";
    }
});
/* Para drop, evita el manejo predeterminado del navegador (en drop, los enlaces se abren por defecto)
Restablece el color del texto de salida y el color del borde del DIV
Usa el método dataTransfer.getData() para obtener los datos arrastrados
El dato del elemento arrastrado con id("drag1")
Adjunta el elemento arrastrado al elemento 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));
    }
});

Pruébalo »


Páginas relacionadas

Tutorial de HTML:Arrastrar y soltar en HTML5

Referencia HTML:Atributo draggable de HTML


事件对象参考手册Objeto de evento Otras extensiones