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

CKTIS / HTML

ondragenter — zpracování vstupu taženého prvku

Atribut ondragenter určuje kód JavaScriptu, který se spustí při události dragenter, když se tažená položka dostane nad cílový prvek. Cíl tak může na vstup reagovat, ale atribut samotné upuštění nezpracovává.

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

Syntaxe

ondragenter="JavaScript statements"

ondragenter je atribut obsluhy události dragenter, dostupný na prvcích HTML. Jeho hodnota obsahuje příkazy JavaScriptu, nikoli pouze název funkce: k zavolání funkce jsou potřeba závorky. V kódu atributu označuje event předanou událost. Odpovídající vlastnost JavaScriptu element.ondragenter přijímá funkci nebo null.

dragenter signalizuje, že se tažená položka dostala nad cíl; neznamená to, že už byla upuštěna. Událost se šíří vzhůru stromem prvků a lze ji zrušit. V modelu zpracování podle standardu HTML je zrušení události dragenter jedním ze způsobů, jak určit aktuální cíl přetažení. V praxi současné prohlížeče zrušení události dragenter k upuštění položky nevyžadují. Chcete-li umožnit upuštění položky na vlastní cíl, zavolejte event.preventDefault() v obsluze události dragover a upuštění zpracujte v obsluze události drop. Na rozdíl od ondragenter se ondragover spouští opakovaně, dokud položka zůstává nad cílem.

Příklad vyvolá syntetickou událost dragenter, aby bylo možné výsledek zopakovat bez ručního tažení. Po kliknutí na Run test je výstup dragenter: true. Tím se potvrzuje pouze to, že volání event.preventDefault() v kódu atributu zrušilo vyvolanou událost. Test neověřuje skutečné tažení, přijetí upuštěné položky ani přenos dat. Bezpečnostní zásady stránky mohou blokovat kód v atributech; alternativou je addEventListener('dragenter', handler).

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragenter demo</title>
<div id="target" ondragenter="event.preventDefault(); document.getElementById('result').textContent = event.type + ': ' + event.defaultPrevented;">Target</div>
<button id="test" type="button">Run test</button>
<output id="result"></output>
<script>
  document.getElementById('test').addEventListener('click', () => {
    document.getElementById('target').dispatchEvent(
      new DragEvent('dragenter', { bubbles: true, cancelable: true })
    );
  });
</script>
</html>

Výsledek

dragenter: true

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