KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

ondragover — slepen boven een element afhandelen

Het attribuut ondragover bevat JavaScript-code die dragover-gebeurtenissen afhandelt terwijl er boven een doel wordt gesleept. Door de gebeurtenis met event.preventDefault() te annuleren, kan een gewoon element een drop accepteren.

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

Syntax

ondragover="event.preventDefault()"

ondragover is het contentattribuut voor de gebeurtenishandler van dragover. De waarde is JavaScript-code, geen Booleaanse waarde. De handler kan event gebruiken; de gebeurtenis wordt herhaaldelijk geactiveerd zolang er boven een doel wordt gesleept, niet alleen wanneer het doel wordt betreden.

Roep bij een gewoon dropdoel event.preventDefault() aan tijdens de afhandeling van dragover. Het annuleren van de gebeurtenis geeft aan dat de bewerking wordt geaccepteerd; alleen event.dataTransfer.dropEffect instellen is niet voldoende. De waarde van dropEffect, zoals copy, moet overeenkomen met effectAllowed van de bron. Sommige bewerkbare elementen hebben standaardgedrag voor het droppen van tekst.

ondragover leest de gesleepte inhoud niet automatisch uit en voegt die ook niet automatisch in. Lees gegevens met getData() in de drop-handler; tijdens dragover staat de gegevensopslag in de beschermde modus. In het voorbeeld slaat dragstart tekst op, annuleren dragenter en dragover hun gebeurtenissen en werkt drop het resultaat bij met textContent.

Maak onderscheid tussen het attribuut en de JavaScript-eigenschap element.ondragover, waaraan je een functie toewijst, en addEventListener('dragover', handler), dat een listener registreert met de gebeurtenisnaam zonder het voorvoegsel on.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragover example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'HELLO'); event.dataTransfer.effectAllowed = 'copy'">Drag HELLO</p>
<div style="padding: 2rem; border: 2px dashed"
     ondragenter="event.preventDefault()"
     ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
     ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')">Drop here</div>
<p id="result" role="status">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.

Bronnen