KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

ondrag — sleepgebeurtenissen afhandelen

Het ondrag-attribuut bevat JavaScript dat de drag-gebeurtenis afhandelt, die tijdens het slepen herhaaldelijk op de bron wordt geactiveerd. Het attribuut maakt een element zelf niet sleepbaar en definieert geen neerzetdoel.

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

Syntax

<element ondrag="JavaScript statements"></element>

ondrag is een attribuut voor gebeurtenisafhandeling dat op alle HTML-elementen beschikbaar is. De waarde is JavaScript-code die wordt uitgevoerd wanneer een drag-gebeurtenis wordt ontvangen. In de attribuutcode geeft de parameter event toegang tot het gebeurtenisobject. Er is ook een overeenkomstige JavaScript-eigenschap: element.ondrag.

Tijdens native slepen activeert de browser periodiek drag op het bronelement. Dit gebeurt niet bij elke beweging van de aanwijzer; ga niet uit van een vaste frequentie. Stel voor een gewoon element draggable="true" in om slepen mogelijk te maken — ondrag alleen doet dat niet.

Maak onderscheid tussen ondragstart (begin), ondrag (slepen is bezig), ondragover (slepen boven een mogelijk doel), ondrop (neerzetten) en ondragend (einde). ondrag vervangt de afhandeling van het neerzetdoel niet. Stel sleepgegevens in bij dragstart; tijdens drag staat de gegevensopslag in de beschermde modus, waardoor de inhoud van de gegevens niet beschikbaar is.

Het voorbeeld wijzigt de statustekst in drag received wanneer drag wordt ontvangen. Volgende gebeurtenissen laten dezelfde tekst staan, zodat het verwachte resultaat niet afhangt van het aantal gebeurtenissen. Sla het HTML-bestand op, open het in een browser en sleep Drag me.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrag example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'demo')"
   ondrag="document.getElementById('status').textContent = 'drag received'">Drag me</p>
<output id="status">ready</output>
</html>

Resultaat

ready → drag received

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