Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

ondrop — spracovanie upustených údajov

Atribút ondrop určuje JavaScriptový kód, ktorý spracuje udalosť drop pri presúvaní. Sám osebe nevytvorí cieľ na upustenie: zvyčajne treba zrušiť aj predvolené spracovanie udalosti dragover.

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

Syntax

ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };

ondrop je globálny atribút HTML na obsluhu udalostí a môže byť uvedený na ľubovoľnom prvku HTML. Jeho hodnotou je JavaScriptový kód, ktorý sa vykoná pri prijatí udalosti drop, teda keď sa údaje upustia na akceptovaný cieľ. Objekt event sprístupňuje udalosť a event.dataTransfer sprístupňuje prenášané údaje.

Samotná obsluha ondrop nevytvorí bežný cieľ na upustenie. V obsluhe dragover zavolaj event.preventDefault(), aby sa údaje dali upustiť. Príklad ruší aj dragenter. V obsluhe drop znova použi event.preventDefault(), čím prevezmeš predvolenú akciu, a prečítaj text pomocou event.dataTransfer.getData('text/plain').

Rozlišuj atribút HTML ondrop, ktorého hodnotou je zdrojový text, od vlastnosti DOM element.ondrop, ktorej sa priradí funkcia alebo null. Názov udalosti je drop, nie ondrop; pri addEventListener použi drop. Opätovné priradenie element.ondrop nahradí predchádzajúcu funkciu zaregistrovanú týmto mechanizmom.

Príklad prenáša pevný text Hello a zobrazuje ho pomocou textContent, bez interpretácie údajov ako HTML. Vyžaduje prostredie, ktoré povoľuje skripty a obsluhu udalostí priamo v atribútoch; bezpečnostné obmedzenia dokumentu ich môžu zablokovať.

Príklady

<!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>

Výsledok

Hello

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje