WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

ondragenter — Eintritt eines gezogenen Elements behandeln

Das Attribut ondragenter legt fest, welcher JavaScript-Code beim Ereignis dragenter ausgeführt wird, wenn ein gezogenes Objekt in den Bereich eines Zielelements gelangt. So kann das Ziel darauf reagieren; das Ablegen selbst behandelt das Attribut nicht.

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

Syntax

ondragenter="JavaScript statements"

ondragenter ist ein auf HTML-Elementen verfügbares Ereignis-Handler-Attribut für dragenter. Sein Wert enthält JavaScript-Anweisungen und nicht nur einen Funktionsnamen: Zum Aufrufen einer Funktion sind Klammern erforderlich. Im Attributcode bezeichnet event das übergebene Ereignis. Die entsprechende JavaScript-Eigenschaft element.ondragenter akzeptiert eine Funktion oder null.

dragenter zeigt an, dass ein gezogenes Objekt in den Zielbereich gelangt ist, nicht, dass es abgelegt wurde. Das Ereignis wird im Elementbaum nach oben weitergereicht und kann abgebrochen werden. Im Verarbeitungsmodell des HTML-Standards ist das Abbrechen von dragenter eine Möglichkeit, das aktuelle Ziel des Drag-and-drop-Vorgangs festzulegen. In der Praxis muss dragenter in aktuellen Browsern nicht abgebrochen werden, damit ein Objekt abgelegt werden kann. Damit ein selbst definiertes Ziel das Ablegen akzeptiert, rufen Sie im Handler für dragover event.preventDefault() auf und behandeln Sie das Ablegen im Handler für drop. Anders als ondragenter wird ondragover wiederholt ausgeführt, solange sich das Objekt über dem Ziel befindet.

Das Beispiel löst ein synthetisches dragenter-Ereignis aus, damit sich das Ergebnis ohne manuelles Ziehen wiederholen lässt. Nach einem Klick auf Run test lautet die Ausgabe dragenter: true. Das bestätigt lediglich, dass der Aufruf von event.preventDefault() im Attributcode das ausgelöste Ereignis abgebrochen hat. Der Test prüft weder einen echten Ziehvorgang noch, ob das Ablegen akzeptiert oder Daten übertragen werden. Sicherheitsrichtlinien der Seite können Code in Attributen blockieren; eine Alternative ist addEventListener('dragenter', handler).

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragenter demo</title>
<div id="target" ondragenter="event.preventDefault(); document.getElementById('result').textContent = event.type + ': ' + event.defaultPrevented;">Target</div>
<button id="test" type="button">Run test</button>
<output id="result"></output>
<script>
  document.getElementById('test').addEventListener('click', () => {
    document.getElementById('target').dispatchEvent(
      new DragEvent('dragenter', { bubbles: true, cancelable: true })
    );
  });
</script>
</html>

Ergebnis

dragenter: true

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.

Quellen