CKTIS / HTML
ondrop — obravnava izpuščenih podatkov
Atribut ondrop določa kodo JavaScript, ki obravnava dogodek drop pri vlečenju in spuščanju. Sam ne ustvari cilja za spuščanje: običajno je treba preklicati tudi privzeto obravnavo dogodka dragover.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };ondrop je globalni atribut HTML za obravnavo dogodkov in je lahko naveden na katerem koli elementu HTML. Njegova vrednost je koda JavaScript, ki se izvede ob prejemu dogodka drop, torej ko so podatki spuščeni na sprejeti cilj. Objekt event omogoča dostop do dogodka, event.dataTransfer pa do prenesenih podatkov.
Sama obravnava ondrop ne vzpostavi običajnega cilja za spuščanje. V obravnavi dragover pokliči event.preventDefault(), da omogočiš spuščanje. Primer prekliče tudi dragenter. V obravnavi drop znova uporabi event.preventDefault(), da prevzameš privzeto dejanje, in preberi besedilo z event.dataTransfer.getData('text/plain').
Razlikuj atribut HTML ondrop, katerega vrednost je izvorno besedilo, od lastnosti DOM element.ondrop, ki ji je mogoče dodeliti funkcijo ali null. Ime dogodka je drop, ne ondrop; pri addEventListener uporabi drop. Ponovna dodelitev element.ondrop zamenja prejšnjo funkcijo, registrirano s tem mehanizmom.
Primer prenese nespremenljivo besedilo Hello in ga prikaže z textContent, ne da bi podatke obravnaval kot HTML. Potrebuje okolje, ki dovoljuje skripte in obravnavo dogodkov neposredno v atributih; varnostne omejitve dokumenta jih lahko blokirajo.
Primeri
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">Waiting</p>
</html>Rezultat
Hello
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.