База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници