CKTIS / HTML
ondrag — obravnava dogodke vlečenja
Atribut ondrag vsebuje JavaScript za obravnavo dogodka drag, ki se med vlečenjem večkrat sproži na izvoru. Sam atribut elementa ne naredi vlečljivega in ne določa cilja za spuščanje.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<element ondrag="JavaScript statements"></element>ondrag je atribut za obravnavo dogodkov, ki je na voljo na vseh elementih HTML. Njegova vrednost je JavaScript, ki se izvede, ko je prejet dogodek drag. V kodi atributa parameter event zagotavlja objekt dogodka. Ustreza mu tudi lastnost JavaScript element.ondrag.
Med izvornim vlečenjem brskalnik periodično sproži drag na izvornem vozlišču. To ni dogodek za vsak premik kazalca; ne predpostavljajte stalne pogostosti. Za omogočanje vlečenja običajnega elementa nastavite draggable="true" — samo ondrag tega ne omogoča.
Razlikujte med ondragstart (začetek), ondrag (vlečenje v teku), ondragover (vlečenje nad morebitnim ciljem), ondrop (spustitev) in ondragend (konec). ondrag ne nadomesti obravnave cilja za spuščanje. Podatke vlečenja nastavite v dragstart; med drag je shramba podatkov v zaščitenem načinu, zato vsebina podatkov ni na voljo.
Primer ob prejemu drag spremeni besedilo stanja v drag received. Nadaljnji dogodki ohranijo isto besedilo, zato pričakovani rezultat ni odvisen od njihovega števila. Shranite datoteko HTML, jo odprite v brskalniku in povlecite Drag me.
Primeri
<!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>Rezultat
ready → drag received
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.