Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

onkeyup — gérer le relâchement d’une touche

L’attribut onkeyup contient du code JavaScript qui gère l’événement keyup après le relâchement d’une touche. C’est un attribut global HTML, et non un moyen de détecter chaque changement de la valeur d’un champ.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

onkeyup="JavaScript statements"

onkeyup est un attribut global HTML de gestion d’événement. Sa valeur contient des instructions JavaScript, et non un nom d’événement ou une adresse de fichier. Il gère keyup, l’événement associé au relâchement d’une touche.

Dans le code de l’attribut, le paramètre event fournit l’événement, et this désigne l’élément qui porte le gestionnaire. L’attribut onkeyup et la propriété JavaScript element.onkeyup représentent le même mécanisme de gestion. Affecter une fonction à cette propriété remplace le gestionnaire précédent.

Ne confonds pas keyup avec une modification du texte. Le relâchement d’une touche ne change pas nécessairement une valeur, et la modification d’un contrôle ne nécessite pas forcément un clavier. Pour réagir aux changements de valeur effectués par l’utilisateur, utilise l’événement input.

L’exemple modifie un message d’état lorsqu’il reçoit keyup. JavaScript doit être activé, et la politique de sécurité de la page doit autoriser les gestionnaires d’événements écrits dans des attributs.

Exemples

<!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>

Résultat

keyup received

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources