CKTIS / HTML
onbeforetoggle — gestionar un próximo cambio de estado
El atributo `onbeforetoggle` establece un controlador para `beforetoggle`. El evento se dispara antes de que se abra un popover, pero no antes de todos los cierres. También se dispara antes de los cambios de estado de un elemento `dialog` iniciados con métodos como `showModal()` o `close()`. Añadir o quitar directamente el atributo `open` de un elemento `dialog` no dispara el evento. El controlador permite examinar el estado anterior y el previsto, y cancelar la apertura.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });onbeforetoggle es un atributo de controlador de eventos para beforetoggle; su valor contiene código JavaScript, no un valor booleano. La propiedad correspondiente es element.onbeforetoggle. El evento se dispara antes de que se abra un popover, pero no antes de todos los cierres. Por ejemplo, al retirar del documento un popover abierto, este se cierra sin disparar beforetoggle. No dependas de este evento para detectar todos los cierres. En un elemento dialog, se dispara, por ejemplo, al abrirlo con show() o showModal() y al cerrarlo con close(). Añadir o quitar directamente el atributo open cambia el estado del elemento dialog sin disparar beforetoggle.
El objeto ToggleEvent expone oldState y newState, cuyos valores son "closed" o "open". Al abrirse, el evento se puede cancelar con event.preventDefault(). Si se dispara al cerrarse, no se puede cancelar. toggle es un evento distinto que informa de un cambio de estado; no lo confundas con beforetoggle.
El código del atributo tiene acceso a event; return false también cancela un evento cancelable. Asignar una función a element.onbeforetoggle sustituye el controlador que ya tuviera esa propiedad. Como alternativa, addEventListener("beforetoggle", handler) permite añadir escuchas independientes.
El ejemplo cancela la apertura solicitada por showPopover(), por lo que el texto esperado es open: false. Se necesita un navegador que implemente estas funciones y permita los controladores de eventos en línea. Añadir onbeforetoggle por sí solo no da a un elemento el comportamiento de popover.
Ejemplos
<!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>Resultado
open: false
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.