keyCodeevent property

事件对象参考手册objet event

Exemple

Obtenez la valeur Unicode de la touche de clavier enfoncée :

var x = event.keyCode;

xLe résultat de sortie est:

119 // 119 est le caractère "w"

Essayez-le vous-même »

Cet article contient plus d'exemples en bas.


Définition et utilisation

La propriété keyCode renvoieonkeypressle code de caractère de la valeur de touche qui a déclenché l'événement, ouonkeydownouonkeyuple code de touche de l'événement.

La différence entre les deux types de codes est :

  • Code de caractère - un nombre représentant un caractère ASCII
  • Code clavier - un nombre représentant la touche réelle sur le clavier

Les deux types de valeurs ne sont pas toujours égaux. Par exemple, le "w" minuscule et le "W" majuscule ont le même code clavier parce qu'il s'agit de la même touche du clavier (le code de "W" est "87"), mais ils ont des codes de caractère différents, et le résultat produit par les deux caractères est différent (les codes de caractère de "w" et "W" sont "119" et "87") - voir les exemples ci-dessous pour mieux comprendre.

Astuce :Si vous avez besoin de savoir si l'utilisateur a appuyé sur une touche imprimable (comme "a" ou "5"), il est recommandé d'utiliser l'événement onkeypress. Si vous avez besoin de savoir si l'utilisateur a appuyé sur une touche de fonction (comme "F1", "CAPS LOCK" ou "Home"), vous pouvez utiliser l'événement onkeydown ou onkeyup.

Remarque :Dans Firefox, la propriété keyCode n'est pas valide dans l'événement onkeypress (renvoie 0). Pour la compatibilité entre navigateurs, vous pouvez utiliser à la foiswhichet la propriété keyCode ensemble pour résoudre ce problème :

var x = event.which || event.keyCode; // utilisewhichoukeyCode, de cette façon il peut prendre en charge différents navigateurs

Astuce :Pour une liste de tous les caractères Unicode, consultez notreManuel de référence Unicode complet。

Astuce :Si vous devez convertir une valeur Unicode en caractère, vous pouvez utiliser la méthodefromCharCode().

Remarque :Cette propriété est en lecture seule.

Remarque :Les propriétés which et keyCode offrent un moyen de résoudre la compatibilité entre navigateurs. La dernière version des événements DOM recommande d'utiliser la propriétékeypour remplacer cette méthode.

Astuce :Si vous voulez vérifier si la touche "ALT", "CTRL", "META" ou "SHIFT" est enfoncée, vous pouvez utiliser la propriété altKey, ctrlKey, metaKey ou shiftKey.


Prise en charge des navigateurs

Propriété
keyCode Oui Oui Oui Oui Oui


Syntaxe

event.keyCode

Détails techniques

Valeur de retour : Un nombre, représentant un code de caractère Unicode ou un code de touche Unicode
Version DOM : Événements DOM niveau 2


实例

Plus d’exemples

Exemple

Utilisez onkeypress et onkeydown pour démontrer la différence entre les codes de caractères et les codes clavier :

<input type="text" onkeypress="uniCharCode(event)" onkeydown="uniKeyCode(event)">

function uniCharCode(event) {
    var char = event.which || event.keyCode;
    document.getElementById("demo").innerHTML = "Code de CARACTÈRE Unicode : " + char;
}

function uniKeyCode(event) {
    var key = event.keyCode;
    document.getElementById("demo2").innerHTML = "Code de TOUCHE Unicode : " + key;
}

Lorsque la touche "a" est enfoncée sur le clavier (sans Verr. Maj), la sortie est la suivante :

Code de caractère Unicode : 97
Code de touche Unicode : 65

Essayez-le vous-même »

Exemple

Si la touche Échap est enfoncée, un message d'invite apparaît :

<input type="text" onkeydown="myFunction(event)">

fonction myFunction(event) {
    var x = event.keyCode;
    if (x == 27) {  // 27 est la touche Échap
        alert ("Vous avez appuyé sur la touche Échap !");
    }
}

Essayez-le vous-même »

Exemple

Convertir une valeur Unicode en caractère (non disponible pour les touches de fonction) :

var x = event.keyCode;                // Obtenir la valeur Unicode
var y = String.fromCharCode(x);       // Convertir la valeur en caractère

Essayez-le vous-même »


Pages associées

Manuel de référence HTML DOM:propriété key de l'événement

Manuel de référence HTML DOM:propriété keyCode de l'événement

Manuel de référence HTML DOM:propriété which de l'événement

事件对象参考手册objet event

Autres extensions