CKTIS / HTML
oncancel — gerir o evento cancel
O atributo oncancel contém o código executado quando é recebido um evento cancel. Num elemento dialog, permite responder a um pedido de fecho e, se o evento for cancelável, impedir o fecho.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel é um atributo de tratamento do evento cancel, disponível em todos os elementos HTML. O seu valor é código JavaScript, não um nome de evento nem um valor booleano. O equivalente em JavaScript é a propriedade element.oncancel, à qual se pode atribuir uma função ou null.
Uma utilização comum é no elemento dialog: cancel assinala um pedido de fecho, não um fecho já concluído. O método requestClose() ativa primeiro cancel; o método close() salta esse passo. O evento close indica, por sua vez, o fecho.
Quando event.cancelable tem o valor true, event.preventDefault() impede o fecho predefinido. Devolver false de um handler oncancel também cancela o evento quando este é cancelável. Não parta do princípio de que todos os pedidos de fecho podem ser bloqueados.
O exemplo abre uma caixa de diálogo não modal e chama requestClose(). O atributo impede o fecho, pelo que o resultado registado é open: true. O close() final remove a caixa de diálogo da vista sem voltar a ativar cancel.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>oncancel</title>
<dialog id="demo" oncancel="event.preventDefault()">
<p>Dialog</p>
</dialog>
<pre id="result"></pre>
<script>
const demo = document.getElementById('demo');
const result = document.getElementById('result');
demo.show();
demo.requestClose();
result.textContent = `open: ${demo.open}`;
demo.close();
</script>Resultado
open: true
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.