Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

ondragstart — gestionar el inicio del arrastre

El atributo ondragstart define el código JavaScript que se ejecuta con el evento dragstart cuando comienza un arrastre. Permite preparar los datos de la operación o cancelar su inicio; por sí solo, no hace que un elemento sea arrastrable.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

ondragstart="JavaScript statements"

ondragstart es un atributo de controlador de eventos disponible en los elementos HTML. Su valor es código JavaScript, no un valor booleano. Gestiona dragstart al comienzo de una operación de arrastre, no cada movimiento del puntero.

En el código del atributo, event es el objeto DragEvent. Durante un dragstart nativo, el almacén de datos del arrastre permite lectura y escritura: event.dataTransfer.setData('text/plain', 'Hello') establece el texto que se transfiere. Llamar a event.preventDefault() o ejecutar return false en este controlador cancela el inicio del arrastre.

ondragstart no habilita el arrastre por sí solo. Para un elemento de origen normal, se puede establecer draggable="true". ondragstart también es el nombre de una propiedad JavaScript que acepta una función; con addEventListener, el nombre del evento es dragstart, sin el prefijo on.

El ejemplo cancela deliberadamente la operación después de cambiar el mensaje de estado. Muestra cómo gestionar el inicio del arrastre, no una implementación completa de la acción de soltar.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragstart example</title>
<p draggable="true"
   ondragstart="document.getElementById('status').textContent = 'dragstart: canceled'; event.preventDefault();">
  Drag this text.
</p>
<p id="status" role="status">Ready</p>
</html>

Resultado

dragstart: canceled

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes