CKTIS / HTML
ondragenter — obrada ulaska povučenog elementa
Atribut ondragenter definira JavaScript koji se izvodi pri događaju dragenter kada povučena stavka dospije iznad ciljnog elementa. Cilj tako može reagirati na ulazak, ali atribut ne obrađuje samo ispuštanje stavke.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
ondragenter="JavaScript statements"ondragenter je atribut za obradu događaja dragenter, dostupan na HTML elementima. Njegova vrijednost sadrži JavaScript naredbe, a ne samo naziv funkcije: za pozivanje funkcije potrebne su zagrade. U kodu atributa event označava proslijeđeni događaj. Odgovarajuće JavaScript svojstvo element.ondragenter prihvaća funkciju ili null.
dragenter označava da je povučena stavka dospjela iznad cilja; to ne znači da je ispuštena. Događaj se širi prema gore kroz stablo elemenata i može se otkazati. U modelu obrade koji propisuje HTML standard otkazivanje događaja dragenter jedan je od načina određivanja trenutačnog cilja povlačenja i ispuštanja. U praksi današnji preglednici ne zahtijevaju otkazivanje događaja dragenter da bi se stavka mogla ispustiti. Da biste omogućili ispuštanje na prilagođeni cilj, pozovite event.preventDefault() u funkciji za obradu događaja dragover, a ispuštanje obradite u funkciji za obradu događaja drop. Za razliku od ondragenter, ondragover se izvodi više puta dok je stavka iznad cilja.
Primjer šalje sintetički događaj dragenter kako bi se rezultat mogao ponoviti bez ručnog povlačenja. Nakon klika na Run test ispis je dragenter: true. To potvrđuje samo da je poziv event.preventDefault() u kodu atributa otkazao poslani događaj. Test ne provjerava stvarno povlačenje, prihvaćanje ispuštene stavke ni prijenos podataka. Sigurnosna pravila stranice mogu blokirati kod u atributima; alternativa je addEventListener('dragenter', handler).
Primjeri
<!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>Rezultat
dragenter: true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.