KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

ondragstart — het begin van slepen afhandelen

Het attribuut ondragstart definieert JavaScript-code die wordt uitgevoerd bij het dragstart-event wanneer het slepen begint. Je kunt er gegevens voor de bewerking mee voorbereiden of het begin ervan annuleren; het maakt een element niet zelf sleepbaar.

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

Syntax

ondragstart="JavaScript statements"

ondragstart is een event-handlerattribuut dat beschikbaar is op HTML-elementen. De waarde is JavaScript-code, geen Booleaanse waarde. Het handelt dragstart af aan het begin van een sleepbewerking, niet bij elke beweging van de aanwijzer.

In de attribuutcode verwijst event naar het DragEvent-object. Tijdens een native dragstart kan de gegevensopslag van de sleepbewerking worden gelezen en beschreven: event.dataTransfer.setData('text/plain', 'Hello') stelt de over te dragen tekst in. Het aanroepen van event.preventDefault() of uitvoeren van return false in deze handler annuleert het begin van het slepen.

ondragstart schakelt slepen op zichzelf niet in. Voor een gewoon bronelement kun je draggable="true" instellen. ondragstart is ook de naam van een JavaScript-eigenschap waaraan een functie kan worden toegewezen; met addEventListener is de eventnaam dragstart, zonder het voorvoegsel on.

Het voorbeeld annuleert de bewerking bewust nadat het statusbericht is gewijzigd. Het laat zien hoe je het begin van het slepen afhandelt, niet hoe je een volledige neerzetfunctionaliteit implementeert.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragstart example</title>
<p draggable="true"
   ondragstart="document.getElementById('status').textContent = 'dragstart: canceled'; event.preventDefault();">
  Drag this text.
</p>
<p id="status" role="status">Ready</p>
</html>

Resultaat

dragstart: canceled

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