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

CKTIS / HTML

ondrag — zpracování událostí přetahování

Atribut ondrag obsahuje JavaScript, který zpracovává událost drag, opakovaně odesílanou zdroji během přetahování. Samotný atribut prvek nepovoluje přetahovat ani neurčuje cíl pro upuštění.

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

Syntaxe

<element ondrag="JavaScript statements"></element>

ondrag je atribut obsluhy události dostupný u všech prvků HTML. Jeho hodnotou je JavaScript vykonaný při přijetí události drag. V kódu atributu poskytuje parametr event objekt události. Odpovídá mu také vlastnost JavaScriptu element.ondrag.

Při nativním přetahování prohlížeč pravidelně vyvolává drag na zdrojovém uzlu. Nejde o událost při každém pohybu ukazatele; nepředpokládejte pevnou frekvenci. Přetahování běžného prvku povolíte nastavením draggable="true" — samotné ondrag to nezajistí.

Rozlišujte ondragstart (začátek), ondrag (probíhající přetahování), ondragover (přetahování nad možným cílem), ondrop (upuštění) a ondragend (konec). ondrag nenahrazuje zpracování cíle pro upuštění. Data přetahování nastavte v dragstart; během drag je úložiště dat v chráněném režimu, takže obsah dat není dostupný.

Příklad při přijetí drag změní stavový text na drag received. Další události ponechají stejný text, takže očekávaný výsledek nezávisí na jejich počtu. Uložte soubor HTML, otevřete ho v prohlížeči a přetáhněte Drag me.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrag example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'demo')"
   ondrag="document.getElementById('status').textContent = 'drag received'">Drag me</p>
<output id="status">ready</output>
</html>

Výsledek

ready → drag received

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