CKTIS / HTML
onkeypress — atributo de tratamento do evento keypress
O atributo global de HTML onkeypress contém código JavaScript que trata o evento keypress. O nome do atributo inclui o prefixo on; o nome do evento não.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onkeypress="JavaScript statements"onkeypress é um atributo global de tratamento de eventos, disponível nos elementos HTML. O seu valor é código JavaScript, não um nome de evento nem um valor booleano. keypress é um evento obsoleto em que não deves confiar ao escrever código novo.
O atributo onkeypress e a propriedade JavaScript element.onkeypress disponibilizam o mesmo mecanismo de tratamento para keypress. Escreve código no atributo; atribui uma função ou null à propriedade. O parâmetro event disponibiliza o evento ao código em execução.
A Content Security Policy pode bloquear o código de tratamento de eventos escrito diretamente nos atributos. Não insiras texto não fiável nos respetivos valores como código.
O exemplo dispara keypress por código para mostrar que o código de tratamento do evento é executado sem ser preciso premir teclas manualmente. O texto esperado é keypress; este teste não determina quando é que um navegador gera o evento keypress ao escrever com o teclado.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeypress demo</title>
<input id="field" aria-label="Text" onkeypress="document.getElementById('result').textContent = event.type">
<output id="result"></output>
<script>
document.getElementById('field').dispatchEvent(
new KeyboardEvent('keypress', { key: 'a' })
);
</script>
</html>Resultado
keypress
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.