CKTIS / HTML
onbeforetoggle — gerir uma alteração de estado iminente
O atributo `onbeforetoggle` define um processador para `beforetoggle`. O evento é acionado antes da abertura de um popover, mas não antes de todos os fechos. Também é acionado antes das alterações de estado de um elemento `dialog` iniciadas com métodos como `showModal()` ou `close()`. Adicionar ou remover diretamente o atributo `open` de um elemento `dialog` não aciona o evento. O processador permite verificar o estado anterior e o pretendido e cancelar a abertura.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });onbeforetoggle é um atributo de processador de eventos para beforetoggle; o seu valor contém código JavaScript, não um valor booleano. A propriedade correspondente é element.onbeforetoggle. O evento é acionado antes de um popover abrir, mas não antes de todos os fechos. Por exemplo, remover do documento um popover aberto fecha-o sem acionar beforetoggle. Não confies, portanto, neste evento para detetar todos os fechos. Num elemento dialog, é acionado, por exemplo, ao abrir com show() ou showModal() e ao fechar com close(). Adicionar ou remover diretamente o atributo open altera o estado do elemento dialog sem acionar beforetoggle.
O objeto ToggleEvent expõe oldState e newState, cujos valores são "closed" ou "open". Durante a abertura, o evento pode ser cancelado com event.preventDefault(). Se for acionado durante o fecho, não é cancelável. toggle é um evento separado que assinala uma alteração de estado; não o confundas com beforetoggle.
O código do atributo tem acesso a event; return false também cancela um evento cancelável. Atribuir uma função a element.onbeforetoggle substitui o processador que já existia nessa propriedade. Em alternativa, addEventListener("beforetoggle", handler) permite adicionar ouvintes independentes.
O exemplo cancela a abertura pedida por showPopover(), pelo que o texto esperado é open: false. É necessário um navegador que implemente estas funcionalidades e permita processadores de eventos em linha. Adicionar onbeforetoggle, por si só, não dá a um elemento o comportamento de popover.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.