CKTIS / HTML
ontoggle — обработване на промени в състоянието на отваряне
Атрибутът ontoggle съдържа JavaScript, който обработва събитието toggle след промяна в състоянието на отваряне на елемент. Това включва details, dialog и елементи, които действат като изскачащи прозорци. Атрибутът сам по себе си не отваря и не затваря елемент.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle е атрибут за обработване на събитието toggle; стойността му е JavaScript код, а не булева стойност. Наличен е за HTML елементи, но добавянето му не създава поведение за разгъване. Събитието се генерира при промяна на състоянието на details, dialog и елементи, които действат като popover.
В кода на атрибута event обозначава събитието, а this — елемента, който го обработва. Обектът ToggleEvent предоставя oldState и newState, чиито стойности са "open" или "closed". toggle съобщава за завършена промяна: не се разпространява чрез bubbling и не може да бъде отменено. preventDefault() няма да върне промяната назад.
Уведомлението се поставя на опашка, а бързи последователни промени могат да бъдат обединени в едно събитие. Затова не приемайте, че обработчикът ще бъде извикан за всяка промяна на състоянието. beforetoggle е отделно събитие, което механизмите с поддръжка за него задействат преди промяна; то не е по-ранна форма на toggle, налична при всяка промяна на details.
В JavaScript можете да присвоите функция на свойството element.ontoggle; следващо присвояване заменя предишната функция в това място за обработчик. addEventListener("toggle", handler) позволява да регистрирате независими слушатели. Примерът използва атрибута, за да покаже синтаксиса му: скриптът отваря details, а обработчикът обновява текста, когато събитието бъде доставено.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ontoggle example</title>
<details id="panel" ontoggle="document.getElementById('status').textContent = event.oldState + ' -> ' + event.newState">
<summary>Details</summary>
<p>Extra information.</p>
</details>
<pre id="status">Waiting</pre>
<script>
document.getElementById('panel').open = true;
</script>
</html>Резултат
closed -> open
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.