CKTIS / HTML
ontoggle — gestionar los cambios del estado de apertura
El atributo ontoggle contiene JavaScript que gestiona el evento toggle después de que cambia el estado de apertura de un elemento. Entre los elementos pertinentes están details, dialog y los que actúan como popovers. El atributo no abre ni cierra un elemento por sí mismo.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle es un atributo de gestión del evento toggle; su valor es código JavaScript, no un valor booleano. Está disponible en los elementos HTML, pero añadirlo no crea un comportamiento de divulgación. El evento se genera cuando cambia el estado de details, dialog y los elementos que actúan como popover.
Dentro del código del atributo, event hace referencia al evento y this al elemento que lo gestiona. El objeto ToggleEvent proporciona oldState y newState, cuyos valores son "open" o "closed". toggle informa de un cambio ya realizado: no se propaga en la fase de burbujeo y no se puede cancelar. preventDefault() no deshace el cambio.
La notificación se pone en cola y varios cambios rápidos sucesivos pueden agruparse en un solo evento. Por tanto, no des por hecho que se llamará al gestor una vez por cada cambio de estado. beforetoggle es un evento distinto que los mecanismos compatibles generan antes de un cambio; no es una forma anterior de toggle disponible para cada cambio de details.
En JavaScript, puedes asignar una función a la propiedad element.ontoggle; otra asignación sustituye la función anterior en ese espacio del gestor. addEventListener("toggle", handler) permite registrar escuchas independientes. El ejemplo usa el atributo para mostrar su sintaxis: el script abre details y el gestor actualiza el texto cuando se entrega el evento.
Ejemplos
<!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>Resultado
closed -> open
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.