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

CKTIS / HTML

onbeforetoggle — обработване на предстояща промяна на състоянието

Атрибутът `onbeforetoggle` задава обработчик на събитието `beforetoggle`. Събитието се задейства преди отваряне на popover, но не и преди всяко затваряне. То се задейства и преди промяна на състоянието на елемент `dialog`, започната чрез метод като `showModal()` или `close()`. Директното добавяне или премахване на атрибута `open` на елемент `dialog` не задейства събитието. Обработчикът позволява да се проверят предишното и предвиденото състояние и да се отмени отварянето.

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

Синтаксис

onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });

onbeforetoggle е атрибут за обработчик на събитието beforetoggle; стойността му съдържа JavaScript код, а не булева стойност. Съответното свойство е element.onbeforetoggle. Събитието се задейства преди отваряне на popover, но не и преди всяко затваряне. Например, ако премахнете отворен popover от документа, той се затваря, без да се задейства beforetoggle. Затова не разчитайте на това събитие, за да установите всяко затваряне. При елемент dialog то се задейства например при отваряне с show() или showModal() и при затваряне с close(). Директното добавяне или премахване на атрибута open променя състоянието на елемента dialog, без да задейства beforetoggle.

Обектът ToggleEvent предоставя oldState и newState, чиито стойности са "closed" или "open". При отваряне събитието може да бъде отменено с event.preventDefault(). Ако се задейства при затваряне, то не може да бъде отменено. toggle е отделно събитие, което съобщава за промяна на състоянието; не го бъркайте с beforetoggle.

Кодът в атрибута има достъп до event; return false също отменя събитие, което подлежи на отмяна. Задаването на функция на element.onbeforetoggle заменя съществуващия обработчик на това свойство. Като алтернатива addEventListener("beforetoggle", handler) позволява добавяне на независими слушатели.

Примерът отменя отварянето, заявено чрез showPopover(), затова очакваният текст е open: false. Необходим е браузър, който поддържа тези функции и разрешава вградени обработчици на събития. Самото добавяне на onbeforetoggle не придава на елемента поведение на popover.

Примери

<!doctype html>
<meta charset="utf-8">
<title>onbeforetoggle</title>
<div id="panel" popover="manual"
     onbeforetoggle="if (event.newState === 'open') event.preventDefault()">
  Popover
</div>
<pre id="result"></pre>
<script>
  const panel = document.getElementById('panel');
  panel.showPopover();
  document.getElementById('result').textContent =
    'open: ' + panel.matches(':popover-open');
</script>

Резултат

open: false

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

Източници