KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTML-gebeurtenissen tijdens slepen

Leer de zeven HTML-sleepevents kennen, hoe ze verdeeld zijn over bron en doel en wanneer DataTransfer kan worden gelezen of gewijzigd. Begrijp waarom dragover preventDefault() nodig heeft en waarom dragend niet bewijst dat iets succesvol is neergezet.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

source.addEventListener("dragstart", handler);
source.addEventListener("drag", handler);
source.addEventListener("dragend", handler);
target.addEventListener("dragenter", handler);
target.addEventListener("dragover", handler);
target.addEventListener("dragleave", handler);
target.addEventListener("drop", handler);

De HTML-gebeurtenissen tijdens slepen zijn zeven gebeurtenissen van de HTML Drag and Drop-API van de browser, geen functie van een bepaalde ECMAScript-editie. De bron ontvangt dragstart wanneer het slepen begint, herhaalde drag-gebeurtenissen tijdens het slepen en dragend wanneer het eindigt. Mogelijke doelen ontvangen dragenter bij binnenkomst, herhaalde dragover-gebeurtenissen, dragleave bij vertrek en drop wanneer een item op een geldig doel wordt neergezet. Het aantal herhalingen en de tussenpozen liggen niet vast.

Maak een gewoon element versleepbaar met draggable = true. Schrijf in dragstart tekst met event.dataTransfer.setData(). Gegevens kunnen alleen in dragstart worden gewijzigd en de inhoud kan worden gelezen in dragstart en drop; controleer in dragover de beschikbare typen in plaats van de inhoud. In de praktijk volstaat het in browsers om preventDefault() aan te roepen in dragover als een aangepast doel de gesleepte gegevens accepteert. Volgens de HTML-standaard moet je echter ook dragenter annuleren om een gewoon element als aangepast neerzetdoel te laten selecteren. Annuleer in drop ook het standaardgedrag en lees de gegevens met getData().

Gebruik dragend voor opruimwerk, ook wanneer de handeling wordt geannuleerd, bijvoorbeeld met Escape; het optreden ervan bewijst geen succes. effectAllowed bepaalt welke handelingen de bron toestaat, terwijl dropEffect de gekozen handeling aangeeft; geen van beide verplaatst automatisch DOM-elementen. Behandel externe gegevens als niet-vertrouwd: controleer waarden en geef tekst weer met textContent.

Het voorbeeld kopieert alleen token-1 en biedt een knop als alternatief voor slepen. Test een echte handeling in de doelbrowser: een synthetische DragEvent bootst niet de volledige door de browser beheerde bewerking na. Bij het slepen van een bestand vanuit het besturingssysteem worden op de pagina geen brongebeurtenissen dragstart of dragend geactiveerd. De beschikbaarheid van Node 24 toont niet aan dat deze browserinterfaces worden ondersteund.

Voorbeelden

const panel = document.createElement("section");
const source = document.createElement("p");
const target = document.createElement("p");
const alternative = document.createElement("button");
const output = document.createElement("p");

source.textContent = "Drag token-1";
source.draggable = true;
target.textContent = "Drop here";
target.style.cssText = "padding: 2rem; border: 2px dashed;";
alternative.type = "button";
alternative.textContent = "Copy token-1 without dragging";
output.setAttribute("role", "status");
output.textContent = "Ready";
panel.append(source, target, alternative, output);
document.body.append(panel);

function accept(value) {
  if (value === "token-1") {
    output.textContent = `Dropped: ${value}`;
  }
}

source.addEventListener("dragstart", (event) => {
  event.dataTransfer.setData("text/plain", "token-1");
  event.dataTransfer.effectAllowed = "copy";
  source.style.opacity = "0.5";
});

target.addEventListener("dragover", (event) => {
  if (event.dataTransfer.types.includes("text/plain")) {
    event.preventDefault();
    event.dataTransfer.dropEffect = "copy";
  }
});

target.addEventListener("drop", (event) => {
  event.preventDefault();
  accept(event.dataTransfer.getData("text/plain"));
});

source.addEventListener("dragend", () => {
  source.style.opacity = "";
});

alternative.addEventListener("click", () => accept("token-1"));

Resultaat

Dropped: token-1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen