CKTIS / HTML
ondragenter — gestire l’ingresso di un elemento trascinato
L’attributo ondragenter definisce il codice JavaScript eseguito con l’evento dragenter quando un elemento trascinato arriva sopra un elemento di destinazione. Permette di reagire all’ingresso, ma non gestisce il rilascio vero e proprio.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ondragenter="JavaScript statements"ondragenter è un attributo per la gestione dell’evento dragenter, disponibile sugli elementi HTML. Il suo valore contiene istruzioni JavaScript, non soltanto il nome di una funzione: per chiamare una funzione servono le parentesi. Nel codice dell’attributo, event indica l’evento passato al gestore. La proprietà JavaScript corrispondente, element.ondragenter, accetta una funzione oppure null.
dragenter segnala che un elemento trascinato è arrivato sopra una destinazione; non significa che sia stato rilasciato. L’evento si propaga verso l’alto nell’albero e può essere annullato. Nel modello di elaborazione dello standard HTML, annullare dragenter è uno dei modi per impostare la destinazione corrente dell’operazione di trascinamento e rilascio. In pratica, nei browser attuali non è necessario annullare dragenter perché il rilascio possa avvenire. Per far sì che una destinazione personalizzata accetti il rilascio, chiama event.preventDefault() nel gestore di dragover e gestisci il rilascio nel gestore di drop. A differenza di ondragenter, ondragover viene eseguito più volte finché l’elemento rimane sopra la destinazione.
L’esempio invia un evento dragenter sintetico per rendere ripetibile il risultato senza trascinare manualmente. Dopo aver fatto clic su Run test, il risultato è dragenter: true. Questo conferma soltanto che la chiamata a event.preventDefault() nel codice dell’attributo ha annullato l’evento inviato. Il test non verifica il trascinamento reale, l’accettazione del rilascio né il trasferimento di dati. Le norme di sicurezza della pagina possono bloccare il codice negli attributi; un’alternativa è addEventListener('dragenter', handler).
Esempi
<!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>Risultato
dragenter: true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.