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

CKTIS / HTML

ondragend — zpracování konce přetahování

Atribut ondragend spustí JavaScript po skončení operace přetahování, a to i při zrušení nebo neúspěšném puštění. Hodí se k vyčištění stavu zdrojového prvku, nikoli k potvrzení, že cíl přijal data.

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

Syntaxe

ondragend="JavaScript statements"

ondragend je obsahový atribut obsluhy události dragend, který lze použít na každém prvku HTML. Jeho hodnotou je kód JavaScriptu, nikoli logická hodnota. V kódu atributu zpřístupňuje parametr event objekt události. Atribut sám přetahování nepovoluje; příklad k tomu používá draggable="true".

Událost dragend se odešle zdrojovému prvku po skončení operace přetahování, včetně zrušení nebo odmítnutého puštění. Na rozdíl od drop nejde o událost, která by signalizovala přijetí dat cílem. Hodí se k odstranění vizuálních indikátorů přetahování. Výsledek operace zjistíš kontrolou event.dataTransfer.dropEffect; hodnota none znamená, že nebyla provedena žádná operace.

V JavaScriptu můžeš také přiřadit funkci vlastnosti element.ondragend nebo zaregistrovat posluchač pomocí element.addEventListener('dragend', handler). Název události je dragend, bez předpony on. Content Security Policy může blokovat kód zapsaný přímo v atributu; v takovém prostředí použij povolený skript s addEventListener.

Příklad nastaví stavový text na Drag ended bez ohledu na to, zda bylo puštění úspěšné. Neimplementuje cíl pro puštění ani přenos dat.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
   ondragend="document.getElementById('status').textContent = 'Drag ended'">
  Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>

Výsledek

Drag ended

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