Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes