Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

ondrop — zpracování upuštěných dat

Atribut ondrop určuje JavaScriptový kód, který zpracuje událost drop při přetahování. Sám o sobě nevytvoří cíl pro upuštění: obvykle je třeba zrušit také výchozí zpracování události dragover.

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

Syntaxe

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

ondrop je globální atribut HTML pro obsluhu událostí a může být uveden na libovolném prvku HTML. Jeho hodnotou je JavaScriptový kód, který se spustí při přijetí události drop, tedy když jsou data upuštěna na přijatý cíl. Objekt event zpřístupňuje událost a event.dataTransfer zpřístupňuje přenášená data.

Samotný obslužný kód ondrop obvyklý cíl pro upuštění nevytvoří. V obsluze dragover zavolej event.preventDefault(), aby bylo možné data upustit. Příklad ruší také dragenter. V obsluze drop znovu použij event.preventDefault(), převezmi tak výchozí akci a přečti text pomocí event.dataTransfer.getData('text/plain').

Rozlišuj atribut HTML ondrop, jehož hodnotou je zdrojový kód, a vlastnost DOM element.ondrop, které se přiřazuje funkce nebo null. Název události je drop, nikoli ondrop; s addEventListener použij drop. Opětovné přiřazení element.ondrop nahradí předchozí funkci zaregistrovanou tímto způsobem.

Příklad přenáší pevný text Hello a zobrazuje ho pomocí textContent, aniž by data interpretoval jako HTML. Vyžaduje prostředí, které povoluje skripty a obslužné kódy událostí přímo v atributech; bezpečnostní omezení dokumentu je mohou zablokovat.

Pří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ýsledek

Hello

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje