Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

ondragenter — spracovanie vstupu ťahaného prvku

Atribút ondragenter určuje kód JavaScriptu, ktorý sa spustí pri udalosti dragenter, keď sa ťahaná položka dostane nad cieľový prvok. Cieľ tak môže na vstup reagovať, ale atribút nespracúva samotné pustenie položky.

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

Syntax

ondragenter="JavaScript statements"

ondragenter je atribút obsluhy udalosti dragenter, dostupný na prvkoch HTML. Jeho hodnota obsahuje príkazy JavaScriptu, nielen názov funkcie: na zavolanie funkcie sú potrebné zátvorky. V kóde atribútu označuje event odovzdanú udalosť. Zodpovedajúca vlastnosť JavaScriptu element.ondragenter prijíma funkciu alebo null.

dragenter signalizuje, že sa ťahaná položka dostala nad cieľ; neznamená to, že už bola pustená. Udalosť sa šíri nahor stromom prvkov a možno ju zrušiť. V modeli spracovania podľa štandardu HTML je zrušenie udalosti dragenter jedným zo spôsobov, ako určiť aktuálny cieľ presúvania. V praxi súčasné prehliadače na pustenie položky nevyžadujú zrušenie udalosti dragenter. Ak chcete umožniť pustenie položky na vlastný cieľ, zavolajte event.preventDefault() v obsluhe udalosti dragover a pustenie spracujte v obsluhe udalosti drop. Na rozdiel od ondragenter sa ondragover spúšťa opakovane, kým položka zostáva nad cieľom.

Príklad vyvolá syntetickú udalosť dragenter, aby sa dal výsledok zopakovať bez ručného ťahania. Po kliknutí na Run test je výstup dragenter: true. To potvrdzuje iba to, že volanie event.preventDefault() v kóde atribútu zrušilo vyvolanú udalosť. Test neoveruje skutočné ťahanie, prijatie pustenej položky ani prenos údajov. Bezpečnostné pravidlá stránky môžu blokovať kód v atribútoch; alternatívou je addEventListener('dragenter', handler).

Prí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ýsledok

dragenter: true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje