CKTIS / HTML
onkeydown — tratar o pressionar de uma tecla
O atributo onkeydown contém código JavaScript que trata o evento keydown. Permite reagir ao pressionar de uma tecla; o objeto event fornece os dados do evento. Não é um atributo booleano.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onkeydown="JavaScript statements"onkeydown é um atributo HTML para tratar o evento keydown. O seu valor é o corpo de uma função JavaScript, não o nome de um evento nem um URL. Escrever apenas o nome de uma função, sem a chamar, não a executa.
No código do atributo, o parâmetro event fornece o evento. O atributo HTML onkeydown="…" e a propriedade JavaScript element.onkeydown configuram o mesmo mecanismo de tratamento. Atribuir uma nova função à propriedade substitui o tratamento existente.
return false cancela a ação predefinida do evento se este puder ser cancelado, mas não interrompe a sua propagação. Uma Content Security Policy pode bloquear os tratamentos escritos diretamente nos atributos. Nunca insira texto não fidedigno no atributo como código.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeydown example</title>
<button type="button" onkeydown="if (event.key === 'Enter') document.getElementById('result').textContent = 'Enter';">Focus here; press Enter</button>
<p id="result" aria-live="polite">Waiting</p>
</html>Resultado
Enter
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.