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

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.

Zdroje