Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

ondragenter — obravnava vstopa vlečenega elementa

Atribut ondragenter določa kodo JavaScript, ki se izvede ob dogodku dragenter, ko povlečeni predmet pride nad ciljni element. Cilj se lahko tako odzove na prihod predmeta, atribut pa ne obravnava samega spuščanja.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

ondragenter="JavaScript statements"

ondragenter je atribut za obravnavo dogodka dragenter, ki je na voljo na elementih HTML. Njegova vrednost vsebuje ukaze JavaScript, ne le imena funkcije: za klic funkcije so potrebni oklepaji. V kodi atributa se event nanaša na podani dogodek. Ustrezna lastnost JavaScript element.ondragenter sprejme funkcijo ali null.

dragenter sporoča, da je povlečeni predmet prišel nad cilj, ne pa, da je bil že spuščen. Dogodek se širi navzgor po drevesu in ga je mogoče preklicati. V modelu obdelave, ki ga določa standard HTML, je preklic dogodka dragenter eden od načinov za določitev trenutnega cilja operacije povleci in spusti. V praksi sodobni brskalniki ne zahtevajo preklica dogodka dragenter, da bi bilo mogoče predmet spustiti. Če želite omogočiti spuščanje na cilj po meri, v obravnavalniku dogodka dragover pokličite event.preventDefault(), spuščanje pa obravnavajte v obravnavalniku dogodka drop. Za razliko od ondragenter se ondragover izvaja večkrat, dokler predmet ostaja nad ciljem.

Primer sproži sintetični dogodek dragenter, da je mogoče rezultat ponoviti brez ročnega vlečenja. Po kliku na Run test je izpis dragenter: true. To potrjuje le, da je klic event.preventDefault() v kodi atributa preklical sproženi dogodek. Preizkus ne preverja dejanskega vlečenja, sprejema spuščenega predmeta ali prenosa podatkov. Varnostna pravila strani lahko blokirajo kodo v atributih; alternativa je addEventListener('dragenter', handler).

Primeri

<!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>

Rezultat

dragenter: true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri