CKTIS / HTML
onbeforeinput — tratar um evento antes da edição
onbeforeinput é um atributo de tratamento do evento beforeinput, relacionado com a edição de dados pelo utilizador. Permite executar JavaScript antes de uma alteração e cancelar a operação predefinida quando o evento pode ser cancelado.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };onbeforeinput é um atributo HTML que contém código de tratamento do evento beforeinput. Está disponível em todos os elementos HTML; adicioná-lo não torna, por si só, um elemento editável. O seu equivalente em JavaScript é a propriedade element.onbeforeinput.
No código do atributo, event refere-se ao evento atual. Chamar event.preventDefault() pode impedir a operação predefinida apenas quando event.cancelable tem o valor true. Não parta do princípio de que todas as alterações podem ser impedidas desta forma.
O valor do atributo é código JavaScript, não o nome de um evento. O exemplo verifica o tratamento e o cancelamento de um beforeinput enviado sinteticamente; não simula a escrita real. Por isso, o valor ABC permanecer inalterado não prova que a edição nativa tenha sido impedida.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>onbeforeinput</title>
<input id="editor" value="ABC" onbeforeinput="if (event.cancelable) event.preventDefault()">
<pre id="result"></pre>
<script>
const editor = document.getElementById('editor');
const event = new Event('beforeinput', { bubbles: true, cancelable: true });
const allowed = editor.dispatchEvent(event);
document.getElementById('result').textContent =
`allowed=${allowed}\ndefaultPrevented=${event.defaultPrevented}\nvalue=${editor.value}`;
</script>Resultado
allowed=false defaultPrevented=true value=ABC
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.