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

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.

Fontes