CKTIS / HTML
ondragstart — obsluha začátku přetahování
Atribut ondragstart určuje JavaScriptový kód, který se spustí při události dragstart na začátku přetahování. Umožňuje připravit data operace nebo zrušit její zahájení; sám o sobě ale prvek nepřetvoří v přetahovatelný.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
ondragstart="JavaScript statements"ondragstart je atribut obsluhy události dostupný u prvků HTML. Jeho hodnotou je kód JavaScriptu, nikoli logická hodnota. Obsluhuje dragstart na začátku operace přetahování, ne při každém pohybu ukazatele.
V kódu atributu označuje event objekt DragEvent. Během nativní události dragstart lze úložiště dat přetahování číst i měnit: event.dataTransfer.setData('text/plain', 'Hello') nastaví přenášený text. Volání event.preventDefault() nebo provedení return false v této obsluze zruší zahájení přetahování.
ondragstart samo přetahování nepovoluje. U běžného zdrojového prvku lze nastavit draggable="true". ondragstart je také název vlastnosti JavaScriptu, které lze přiřadit funkci; při použití addEventListener je název události dragstart, bez předpony on.
Příklad záměrně zruší operaci po změně stavové zprávy. Ukazuje obsluhu začátku přetahování, nikoli úplnou implementaci odložení.
Příklady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragstart example</title>
<p draggable="true"
ondragstart="document.getElementById('status').textContent = 'dragstart: canceled'; event.preventDefault();">
Drag this text.
</p>
<p id="status" role="status">Ready</p>
</html>Výsledek
dragstart: canceled
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.