keyCodeevent property
Exemple
Obtenez la valeur Unicode de la touche de clavier enfoncée :
xLe résultat de sortie est:
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 :
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
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 :
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 touche Unicode : 65
Essayez-le vous-même »
Exemple
Si la touche Échap est enfoncée, un message d'invite apparaît :
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 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
Autres extensions
objet event