Propriété charCode de KeyboardEvent

❮ Précédent Référence des événements Suivant ❯

Exemple

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

var x = event.charCode;

Plus d'exemples "Essayez-le vous-même" ci-dessous.

Définition et utilisation

La propriété charCode renvoie le code de caractère Unicode de la touche qui a déclenché l' événement onkeypress .

Le code de caractère Unicode est le numéro d'un caractère (par exemple le nombre « 97 » représente la lettre « a »).

Conseil : Pour obtenir une liste de tous les caractères Unicode, veuillez consulter notre Référence Unicode complète .

Astuce : Si vous souhaitez convertir la valeur Unicode en caractère, utilisez la méthode fromCharCode() .

Remarque : Si cette propriété est utilisée sur des événements onkeydown ou onkeyup , la valeur renvoyée est toujours "0".

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

Remarque : La propriété charCode n'est pas prise en charge dans IE8 et versions antérieures. Cependant, pour ces versions de navigateur, vous pouvez utiliser la propriété keyCode . Ou, pour une solution multi-navigateur, vous pouvez utiliser le code suivant :

var x = event.charCode || event.keyCode; // Use either charCode or keyCode, depending on browser support

Astuce : Vous pouvez également utiliser la propriété keyCode pour détecter des touches spéciales (par exemple "verrouillage des majuscules" ou touches fléchées). Cependant, les propriétés keyCode et charCode sont fournies à des fins de compatibilité uniquement. La dernière version de la spécification des événements DOM recommande d'utiliser la propriété key à la place (si disponible).

Astuce : Si vous souhaitez savoir si la touche "ALT", "CTRL", "META" ou "SHIFT" a été enfoncée lorsqu'un événement de touche s'est produit, utilisez la propriété altKey , ctrlKey , metaKey ou shiftKey .

Prise en charge du navigateur

Les nombres dans le tableau indiquent la première version du navigateur qui prend entièrement en charge la propriété.

Property
charCode	Yes	9.0	Yes	Yes	Yes

Syntaxe

event.charCode

Détails techniques

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

Plus d'exemples

Exemple

Une solution multi-navigateur pour obtenir la valeur Unicode de la touche du clavier enfoncée :

// Use charCode if the browser supports it, otherwise use keyCode (for IE8 and earlier)
var x = event.charCode || event.keyCode;

Exemple

Alerter un texte si l'utilisateur appuie sur la touche "O":

function myFunction(event) {
  var x = event.charCode || event.keyCode;
  if (x == 111 || x == 79) { // o is 111, O is 79
    alert("You pressed the 'O' key!");
  }
}