CKTIS / HTML
ondragend — het einde van een sleepactie afhandelen
Het ondragend-attribuut voert JavaScript uit wanneer een sleepactie eindigt, ook als die wordt geannuleerd of het neerzetten mislukt. Het is geschikt om de status van het bronelement op te ruimen, niet om te bevestigen dat een doel gegevens heeft geaccepteerd.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ondragend="JavaScript statements"ondragend is een event-handler-contentattribuut voor dragend en is toegestaan op elk HTML-element. De waarde is JavaScript-code, geen booleaanse waarde. Binnen de attribuutcode geeft de parameter event toegang tot het gebeurtenisobject. Het attribuut schakelt slepen niet zelf in; daarvoor gebruikt het voorbeeld draggable="true".
De gebeurtenis dragend wordt naar de bron gestuurd wanneer de sleepactie eindigt, ook bij annulering of een geweigerde neerzetactie. In tegenstelling tot drop is dit niet de gebeurtenis waarmee het doel aangeeft dat gegevens zijn geaccepteerd. De gebeurtenis is geschikt om visuele sleepmarkeringen te verwijderen. Controleer event.dataTransfer.dropEffect om de uitkomst van de actie te bepalen; none betekent dat er geen actie is uitgevoerd.
In JavaScript kun je ook een functie toewijzen aan de eigenschap element.ondragend of een listener registreren met element.addEventListener('dragend', handler). De gebeurtenisnaam is dragend, zonder het voorvoegsel on. Content Security Policy kan code blokkeren die rechtstreeks in een attribuut staat; gebruik in die omgeving een toegestaan script met addEventListener.
Het voorbeeld stelt de statustekst in op Drag ended, ongeacht of het neerzetten slaagt. Het implementeert geen neerzetdoel of gegevensoverdracht.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
ondragend="document.getElementById('status').textContent = 'Drag ended'">
Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>Resultaat
Drag ended
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.