CKTIS / HTML
ondragenter — обработване на навлизането на влачен елемент
Атрибутът ondragenter задава JavaScript код, който се изпълнява при събитието dragenter, когато влачен обект попадне над целеви елемент. Така целта може да реагира на навлизането, но атрибутът не обработва самото пускане.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
ondragenter="JavaScript statements"ondragenter е атрибут за обработка на събитието dragenter, наличен за HTML елементите. Стойността му съдържа JavaScript инструкции, а не само име на функция: за извикване на функция са нужни скоби. В кода на атрибута event се отнася до подаденото събитие. Съответното JavaScript свойство element.ondragenter приема функция или null.
dragenter показва, че влачен обект е попаднал над целта, а не че вече е пуснат. Събитието се разпространява нагоре по дървото на елементите и може да бъде отменено. В модела за обработка на стандарта HTML отмяната на dragenter е един от начините за задаване на текущата цел на операцията по влачене и пускане. На практика съвременните браузъри не изискват отмяна на dragenter, за да може обектът да бъде пуснат. За да позволите пускане върху зададена от вас цел, извикайте event.preventDefault() в обработчика на dragover, а самото пускане обработете в обработчика на drop. За разлика от ondragenter, ondragover се изпълнява многократно, докато обектът остава над целта.
Примерът изпраща синтетично събитие dragenter, за да може резултатът да се повтори без ръчно влачене. След щракване върху Run test изходът е dragenter: true. Това потвърждава единствено, че извикването на event.preventDefault() в кода на атрибута е отменило изпратеното събитие. Тестът не проверява реално влачене, приемане на пуснат обект или прехвърляне на данни. Правилата за сигурност на страницата могат да блокират кода в атрибути; алтернатива е addEventListener('dragenter', handler).
Примери
<!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>Резултат
dragenter: true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.