Evento ondragstart

❮ Anterior Referencia de eventos Siguiente ❯

Ejemplo

Ejecute un JavaScript cuando el usuario comience a arrastrar un elemento <p>:

Más ejemplos de "Pruébelo usted mismo" a continuación.

Definición y uso

El evento ondragstart ocurre cuando el usuario comienza a arrastrar un elemento o una selección de texto.

Arrastrar y soltar es una característica muy común en HTML5. Es cuando "agarras" un objeto y lo arrastras a una ubicación diferente. Para obtener más información, consulte nuestro Tutorial de HTML sobre HTML5 Arrastrar y soltar .

Nota: Para hacer que un elemento se pueda arrastrar, use el atributo global de HTML5 que se puede arrastrar .

Sugerencia: Los enlaces y las imágenes se pueden arrastrar de forma predeterminada y no necesitan el atributo arrastrable.

Hay muchos eventos que se utilizan y pueden ocurrir en las diferentes etapas de una operación de arrastrar y soltar:

Eventos activados en el objetivo arrastrable (el elemento de origen) :
- ondragstart: ocurre cuando el usuario comienza a arrastrar un elemento
- ondrag - ocurre cuando se arrastra un elemento
- ondragend - ocurre cuando el usuario ha terminado de arrastrar el elemento

Eventos activados en el destino de colocación:
- ondragenter : ocurre cuando el elemento arrastrado ingresa al destino de colocación
- ondragover : ocurre cuando el elemento arrastrado está sobre el destino de colocación
- ondragleave : se produce cuando el elemento arrastrado abandona el destino de colocación
- ondrop : ocurre cuando el elemento arrastrado se suelta en el destino de colocación

Compatibilidad con navegador

Los números de la tabla especifican la primera versión del navegador que es totalmente compatible con el evento.

Event
ondragstart	4.0	9.0	3.5	6.0	12.0

Sintaxis

En HTML:

<element ondragstart="myScript">

En JavaScript:

object.ondragstart = function(){myScript};

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

object.addEventListener("dragstart", myScript);

Nota: el método addEventListener() no es compatible con Internet Explorer 8 y versiones anteriores.

Detalles técnicos

Burbujas:	sí
Cancelable:	sí
Tipo de evento:	Evento de arrastre
Etiquetas HTML compatibles:	Todos los elementos HTML
Versión DOM:	Eventos de nivel 3

Más ejemplos

Ejemplo

Una demostración de TODOS los posibles eventos de arrastrar y soltar:

<p draggable="true" id="dragtarget">Drag me!</p>

<div class="droptarget">Drop here!</div>

<script>
// Events fired on the drag target

document.addEventListener("dragstart", function(event) {
// The dataTransfer.setData() method sets the data type and the value of the dragged data
  event.dataTransfer.setData("Text", event.target.id);

  // Output some text when starting to drag the p element
  document.getElementById("demo").innerHTML = "Started to drag the p element.";

  // Change the opacity of the draggable element
  event.target.style.opacity = "0.4";
});

// While dragging the p element, change the color of the output text
document.addEventListener("drag", function(event) {
document.getElementById("demo").style.color = "red";
});

// Output some text when finished dragging the p element and reset the opacity
document.addEventListener("dragend", function(event) {
  document.getElementById("demo").innerHTML = "Finished dragging the p element.";
  event.target.style.opacity = "1";
});

// Events fired on the drop target

// When the draggable p element enters the droptarget, change the DIVS's border style
document.addEventListener("dragenter", function(event) {
if ( event.target.className == "droptarget" ) {
    event.target.style.border = "3px dotted red";
  }
});

// By default, data/elements cannot be dropped in other elements. To allow a drop, we must prevent the default handling of the element
document.addEventListener("dragover", function(event) {
  event.preventDefault();
});

// When the draggable p element leaves the droptarget, reset the DIVS's border style
document.addEventListener("dragleave", function(event) {
if ( event.target.className == "droptarget" ) {
    event.target.style.border = "";
  }
});

/* On drop - Prevent the browser default handling of the data (default is open as link on drop)
Reset the color of the output text and DIV's border color
Get the dragged data with the dataTransfer.getData() method
The dragged data is the id of the dragged element ("drag1")
Append the dragged element into the drop element
*/
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>