KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

ondragenter — de binnenkomst van een gesleept item afhandelen

Het attribuut ondragenter definieert JavaScript dat wordt uitgevoerd bij de gebeurtenis dragenter wanneer een gesleept item boven een doelelement komt. Het doel kan daarop reageren, maar het attribuut handelt het neerzetten zelf niet af.

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

Syntax

ondragenter="JavaScript statements"

ondragenter is een attribuut voor het afhandelen van de gebeurtenis dragenter, beschikbaar op HTML-elementen. De waarde bevat JavaScript-instructies, niet alleen een functienaam: om een functie aan te roepen zijn haakjes nodig. In de attribuutcode verwijst event naar de doorgegeven gebeurtenis. De bijbehorende JavaScript-eigenschap, element.ondragenter, accepteert een functie of null.

dragenter geeft aan dat een gesleept item boven een doel is gekomen, niet dat het is neergezet. De gebeurtenis bubbelt omhoog in de elementboom en kan worden geannuleerd. In het verwerkingsmodel van de HTML-standaard is het annuleren van dragenter een manier om het huidige doel voor de sleep-en-neerzetbewerking in te stellen. In de praktijk hoeft dragenter in huidige browsers niet te worden geannuleerd om een item te kunnen neerzetten. Om neerzetten op een zelf gedefinieerd doel toe te staan, roep je event.preventDefault() aan in de handler voor dragover en handel je het neerzetten af in de handler voor drop. Anders dan ondragenter wordt ondragover herhaaldelijk uitgevoerd zolang het item boven het doel blijft.

Het voorbeeld verstuurt een synthetische dragenter-gebeurtenis, zodat het resultaat herhaalbaar is zonder handmatig te slepen. Na een klik op Run test is de uitvoer dragenter: true. Dit bevestigt alleen dat de aanroep van event.preventDefault() in de attribuutcode de verstuurde gebeurtenis heeft geannuleerd. De test controleert niet of er in een echte sleepactie kan worden gesleept of neergezet, of dat er gegevens worden overgedragen. Beveiligingsbeleid van de pagina kan code in attributen blokkeren; een alternatief is addEventListener('dragenter', handler).

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragenter demo</title>
<div id="target" ondragenter="event.preventDefault(); document.getElementById('result').textContent = event.type + ': ' + event.defaultPrevented;">Target</div>
<button id="test" type="button">Run test</button>
<output id="result"></output>
<script>
  document.getElementById('test').addEventListener('click', () => {
    document.getElementById('target').dispatchEvent(
      new DragEvent('dragenter', { bubbles: true, cancelable: true })
    );
  });
</script>
</html>

Resultaat

dragenter: true

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