CKTIS / HTML
ondrop — neergezette gegevens verwerken
Het ondrop-attribuut definieert JavaScript-code die het drop-event bij slepen en neerzetten verwerkt. Op zichzelf maakt het geen neerzetdoel: meestal moet ook de standaardafhandeling van dragover worden geannuleerd.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };ondrop is een globaal HTML-attribuut voor eventafhandeling en kan op elk HTML-element staan. De waarde is JavaScript-code die wordt uitgevoerd wanneer een drop-event plaatsvindt, oftewel wanneer gegevens op een geaccepteerd doel worden neergezet. Het object event geeft toegang tot het event en event.dataTransfer tot de overgedragen gegevens.
Een ondrop-handler alleen maakt geen gebruikelijk neerzetdoel. Roep event.preventDefault() aan in de dragover-handler om neerzetten toe te staan. Het voorbeeld annuleert ook dragenter. Gebruik in de drop-handler opnieuw event.preventDefault() om de standaardactie over te nemen, en lees tekst met event.dataTransfer.getData('text/plain').
Maak onderscheid tussen het HTML-attribuut ondrop, waarvan de waarde brontekst is, en de DOM-eigenschap element.ondrop, waaraan je een functie of null toewijst. De eventnaam is drop, niet ondrop; bij addEventListener gebruik je drop. Een nieuwe toewijzing aan element.ondrop vervangt de eerdere functie die via dit mechanisme is geregistreerd.
Het voorbeeld draagt de vaste tekst Hello over en toont die via textContent, zonder de gegevens als HTML te interpreteren. Het vereist een omgeving die scripts en inline eventhandlers toestaat; beveiligingsbeperkingen van het document kunnen deze blokkeren.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">Waiting</p>
</html>Resultaat
Hello
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.