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

CKTIS / HTML

oncancel — обработване на събитието cancel

Атрибутът oncancel съдържа код, който се изпълнява при получаване на събитие cancel. При елемент dialog той позволява да реагирате на заявка за затваряне и да предотвратите затварянето, ако събитието може да бъде отменено.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };

oncancel е атрибут за обработване на събитието cancel, наличен за всички HTML елементи. Стойността му е JavaScript код, а не име на събитие или булева стойност. Съответстващото свойство в JavaScript е element.oncancel, на което може да се присвои функция или null.

Обичайна употреба е при елемента dialog: cancel сигнализира заявка за затваряне, а не вече извършено затваряне. Методът requestClose() първо задейства cancel; методът close() пропуска тази стъпка. Събитието close, от друга страна, съобщава за затварянето.

Когато event.cancelable е true, event.preventDefault() предотвратява затварянето по подразбиране. Връщането на false от обработчик oncancel също отменя събитието, ако то може да бъде отменено. Не приемайте, че всяка заявка за затваряне може да бъде блокирана.

Примерът отваря немодален диалогов прозорец и извиква requestClose(). Атрибутът предотвратява затварянето, затова записаният резултат е open: true. Последният close() премахва диалоговия прозорец от изгледа, без да задейства cancel отново.

Примери

<!doctype html>
<meta charset="utf-8">
<title>oncancel</title>
<dialog id="demo" oncancel="event.preventDefault()">
  <p>Dialog</p>
</dialog>
<pre id="result"></pre>
<script>
  const demo = document.getElementById('demo');
  const result = document.getElementById('result');
  demo.show();
  demo.requestClose();
  result.textContent = `open: ${demo.open}`;
  demo.close();
</script>

Резултат

open: true

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

Източници