CKTIS / HTML
ondragstart — den Beginn des Ziehens behandeln
Das Attribut ondragstart legt JavaScript fest, das beim Ereignis dragstart ausgeführt wird, wenn ein Ziehvorgang beginnt. Damit lassen sich Daten für den Vorgang vorbereiten oder sein Beginn abbrechen; das Attribut macht ein Element nicht selbst ziehbar.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ondragstart="JavaScript statements"ondragstart ist ein Ereignisbehandlungsattribut, das für HTML-Elemente verfügbar ist. Sein Wert ist JavaScript-Code und kein boolescher Wert. Es behandelt dragstart zu Beginn eines Ziehvorgangs, nicht bei jeder Bewegung des Zeigers.
Im Attributcode bezeichnet event das DragEvent-Objekt. Während eines nativen dragstart kann der Datenspeicher des Ziehvorgangs gelesen und beschrieben werden: event.dataTransfer.setData('text/plain', 'Hello') legt den übertragenen Text fest. Der Aufruf von event.preventDefault() oder die Ausführung von return false in diesem Handler bricht den Beginn des Ziehens ab.
ondragstart allein aktiviert das Ziehen nicht. Für ein gewöhnliches Quellelement kann draggable="true" festgelegt werden. ondragstart ist außerdem der Name einer JavaScript-Eigenschaft, der eine Funktion zugewiesen werden kann; mit addEventListener lautet der Ereignisname dragstart, ohne das Präfix on.
Das Beispiel bricht den Vorgang absichtlich ab, nachdem die Statusmeldung geändert wurde. Es zeigt die Behandlung des Beginns eines Ziehvorgangs, keine vollständige Implementierung des Ablegens.
Beispiele
<!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>Ergebnis
dragstart: canceled
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.