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

CKTIS / HTML

onkeyup — tratar a libertação de uma tecla

O atributo onkeyup contém código JavaScript que trata o evento keyup depois de uma tecla ser libertada. É um atributo global de HTML, não uma forma de detetar todas as alterações ao valor de um campo.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

onkeyup="JavaScript statements"

onkeyup é um atributo global de HTML para tratamento de eventos. O seu valor contém instruções JavaScript, não o nome de um evento nem o endereço de um ficheiro. Trata keyup, o evento associado à libertação de uma tecla.

No código do atributo, o parâmetro event disponibiliza o evento e this refere-se ao elemento que contém o controlador. O atributo onkeyup e a propriedade JavaScript element.onkeyup representam o mesmo mecanismo de tratamento. Atribuir uma função à propriedade substitui o controlador anterior.

Não confundas keyup com alterações de texto. Libertar uma tecla não tem necessariamente de alterar um valor, e editar um controlo não tem necessariamente de envolver um teclado. Para reagir a alterações de valor feitas pelo utilizador, usa o evento input.

O exemplo altera uma mensagem de estado quando recebe keyup. O JavaScript tem de estar ativado e a política de segurança da página tem de permitir controladores de eventos escritos em atributos.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeyup demo</title>
<label>Test field
  <input type="text" onkeyup="document.getElementById('result').textContent = 'keyup received'">
</label>
<p id="result" role="status">Waiting</p>
</html>

Resultado

keyup received

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