CKTIS / HTML
ondragover — Ziehen über einem Element behandeln
Das Attribut ondragover enthält JavaScript-Code zur Behandlung von dragover-Ereignissen, während ein Ziehvorgang über einem Ziel stattfindet. Wird das Ereignis mit event.preventDefault() abgebrochen, kann ein gewöhnliches Element einen Drop akzeptieren.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ondragover="event.preventDefault()"ondragover ist das Event-Handler-Inhaltsattribut für dragover. Sein Wert ist JavaScript-Code, kein boolescher Wert. Der Handler kann auf event zugreifen; das Ereignis wird wiederholt ausgelöst, während über ein Ziel gezogen wird, nicht nur beim Betreten des Ziels.
Rufe bei einem gewöhnlichen Drop-Ziel während der Behandlung von dragover event.preventDefault() auf. Das Abbrechen des Ereignisses signalisiert, dass der Vorgang akzeptiert wird; allein event.dataTransfer.dropEffect zu setzen, reicht nicht aus. Der Wert von dropEffect, etwa copy, muss mit effectAllowed der Quelle vereinbar sein. Einige bearbeitbare Elemente haben ein standardmäßiges Verhalten zum Ablegen von Text.
ondragover liest den gezogenen Inhalt nicht automatisch aus und fügt ihn auch nicht automatisch ein. Lies Daten im drop-Handler mit getData() aus; während dragover befindet sich der Datenspeicher im geschützten Modus. Im Beispiel speichert dragstart Text, dragenter und dragover brechen ihre Ereignisse ab, und drop aktualisiert das Ergebnis mit textContent.
Unterscheide das Attribut von der JavaScript-Eigenschaft element.ondragover, der eine Funktion zugewiesen wird, und von addEventListener('dragover', handler), das einen Listener unter dem Ereignisnamen ohne das Präfix on registriert.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragover example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'HELLO'); event.dataTransfer.effectAllowed = 'copy'">Drag HELLO</p>
<div style="padding: 2rem; border: 2px dashed"
ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')">Drop here</div>
<p id="result" role="status">Waiting</p>
</html>Ergebnis
HELLO
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.