Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

ondragstart — gérer le début du glissement

L’attribut ondragstart définit le code JavaScript exécuté lors de l’événement dragstart, au début d’un glissement. Il permet de préparer les données de l’opération ou d’en annuler le lancement ; à lui seul, il ne rend pas un élément déplaçable.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

ondragstart="JavaScript statements"

ondragstart est un attribut de gestion d’événement disponible sur les éléments HTML. Sa valeur est du code JavaScript, et non une valeur booléenne. Il traite dragstart au début d’une opération de glissement, et non à chaque mouvement du pointeur.

Dans le code de l’attribut, event désigne l’objet DragEvent. Pendant un événement natif dragstart, le magasin de données du glissement est accessible en lecture et en écriture : event.dataTransfer.setData('text/plain', 'Hello') définit le texte transféré. Appeler event.preventDefault() ou exécuter return false dans ce gestionnaire annule le début du glissement.

ondragstart n’active pas à lui seul le glissement. Pour un élément source ordinaire, vous pouvez définir draggable="true". ondragstart est aussi le nom d’une propriété JavaScript qui accepte une fonction ; avec addEventListener, le nom de l’événement est dragstart, sans le préfixe on.

L’exemple annule volontairement l’opération après avoir modifié le message d’état. Il montre comment gérer le début d’un glissement, et non une implémentation complète du dépôt.

Exemples

<!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>

Résultat

dragstart: canceled

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources