CKTIS / HTML
onclose — обработване на събитие close
Атрибутът onclose съдържа JavaScript код за обработване на събитието close. Обичайна употреба е реакция при затваряне на елемент dialog, например прочитане на неговия returnValue. Атрибутът не служи за предотвратяване на затварянето.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
onclose="JavaScript statements"onclose е глобален атрибут за обработчик на събитието close. Стойността му е JavaScript код, а не булева стойност. Може да се зададе на всеки HTML елемент, но самото добавяне на атрибута не кара елемента да излъчва това събитие.
Обичайна употреба е при елемента dialog. Извикването на close() затваря отворен диалогов прозорец и поставя събитие close на опашка. В обработчика на атрибута this сочи към елемента, а event предоставя обекта на събитието. Резултатът от затварянето се прочита чрез this.returnValue.
Събитието close на елемент dialog не се разпространява и не може да бъде отменено. За да предотвратите заявка за затваряне, обработете отменяемото събитие cancel; самото close() пропуска тази стъпка. Ръчното премахване на атрибута open не задейства close.
Не бъркайте атрибута със свойството на JavaScript element.onclose, на което се присвоява функция, или с addEventListener('close', handler), който позволява регистриране на няколко слушателя. В примера обработчикът прочита резултата done и актуализира текста едва след доставянето на събитието, поставено на опашка.
Примери
<!doctype html>
<meta charset="utf-8">
<title>onclose</title>
<dialog id="demo" onclose="document.getElementById('result').textContent = 'closed: ' + this.returnValue">
<p>Dialog</p>
</dialog>
<output id="result">waiting</output>
<script>
const dialog = document.getElementById('demo');
dialog.show();
dialog.close('done');
</script>Резултат
closed: done
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.