Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HTMLElement: dragenter-Ereignis

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Das dragenter-Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine gezogene Textauswahl in ein gültiges Ablageziel eintritt. Das Zielobjekt ist die unmittelbare Benutzerauswahl (das Element, das der Benutzer direkt als Ablageziel angibt) oder das <body>-Element.

Dieses Ereignis kann abgebrochen werden und sich bis zu den Objekten Document und Window ausbreiten.

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

js
addEventListener("dragenter", (event) => { })

Alternativ können Sie ihn der Ereignisbehandlungseigenschaft der Schnittstelle zuweisen:

js
ondragenter = (event) => { }

Ereignistyp

Ein DragEvent. Erbt von Event.

Event UIEvent MouseEvent DragEvent

Beispiele

Ablagezonen bei dragenter gestalten

In diesem Beispiel befindet sich ein ziehbares Element innerhalb eines Containers. Versuchen Sie, das Element zu greifen, es über den anderen Container zu ziehen und dort loszulassen.

Wir reagieren auf das dragenter-Ereignis, um dem anderen Container einen violetten Hintergrund zu geben, solange sich das ziehbare Element darüber befindet. So wird signalisiert, dass das Element auf dem Container abgelegt werden könnte.

In diesem unvollständigen Beispiel ist das Ablegen jedoch nicht implementiert. Ein vollständiges Drag-and-Drop-Beispiel finden Sie auf der Seite zum drag-Ereignis.

HTML

html
<div class="dropzone">
  <div id="draggable" draggable="true">This div is draggable</div>
</div>
<div class="dropzone" id="drop-target"></div>

CSS

css
body {
  /* Prevent the user from selecting text in the example */
  user-select: none;
}

#draggable {
  text-align: center;
  background: white;
}

.dropzone {
  width: 200px;
  height: 20px;
  background: blueviolet;
  margin: 10px;
  padding: 10px;
}

.dropzone.dragover {
  background-color: purple;
}

JavaScript

js
const target = document.getElementById("drop-target");
target.addEventListener("dragenter", (event) => {
  // highlight potential drop target when the draggable element enters it
  if (event.target.classList.contains("dropzone")) {
    event.target.classList.add("dragover");
  }
});

target.addEventListener("dragleave", (event) => {
  // reset background of potential drop target when the draggable element leaves it
  if (event.target.classList.contains("dropzone")) {
    event.target.classList.remove("dragover");
  }
});

Ergebnis

Spezifikationen

Spezifikation
HTML
# handler-ondragenter
HTML
# event-dnd-dragenter

Browser-Kompatibilität

Siehe auch