WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

ondragleave — das Verlassen eines Drag-Ziels behandeln

Das Attribut ondragleave enthält JavaScript zur Behandlung des dragleave-Ereignisses. Damit lässt sich beispielsweise die Hervorhebung des vorherigen Ziels während eines Ziehvorgangs entfernen; es bedeutet nicht, dass der gesamte Ziehvorgang beendet ist.

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

Syntax

ondragleave="JavaScript statements"

ondragleave ist ein Ereignisbehandlungsattribut, das für HTML-Elemente verfügbar ist. Sein Wert ist der JavaScript-Funktionskörper, nicht ein Ereignisname oder ein boolescher Wert. Es entspricht dem Ereignis dragleave; im Attributcode steht event für das Ereignis und this für das Element, das es behandelt.

Der Browser sendet dragleave an das vorherige Zielelement, wenn sich das Drag-Ziel ändert; das Ereignis kann auch auftreten, wenn der Vorgang abgebrochen wird. Verwechsle es nicht mit dragend, das die Quelle und das Ende des Ziehvorgangs betrifft. dragleave steigt im DOM-Baum auf und ist nicht abbrechbar: preventDefault() kann das Verlassen des Ziels nicht verhindern. Berücksichtige bei verschachtelten Elementen auch Ereignisse, die von Nachfahren ausgehen.

Das HTML-Attribut enthält Code als Text; der Eigenschaft element.ondragleave weist man eine Funktion oder null zu. Eine weitere Möglichkeit ist addEventListener('dragleave', handler). Eine Content Security Policy kann Code in Attributen blockieren.

Das Beispiel löst beim Klicken auf Test absichtlich ein synthetisches Ereignis aus, sodass sich das Ergebnis ohne Ziehen mit der Maus wiederholen lässt. Es prüft die Ausführung des Handlers, nicht den nativen Drag-and-drop-Mechanismus.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragleave test</title>
<div id="zone" ondragleave="this.textContent = 'dragleave received'">Waiting</div>
<button type="button" id="test">Test</button>
<script>
  const zone = document.getElementById('zone');
  document.getElementById('test').addEventListener('click', () => {
    zone.dispatchEvent(new DragEvent('dragleave', {
      bubbles: true,
      cancelable: false
    }));
  });
</script>
</html>

Ergebnis

dragleave received

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