KeyboardEvent : propriété charCode
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
La propriété en lecture seule charCode de l'interface KeyboardEvent retourne la valeur Unicode d'une touche caractère pressée lors d'un évènement keypress.
Attention :
Ne pas utiliser cette propriété, elle est dépréciée. Pour obtenir la valeur Unicode du caractère, utilisez la propriété key.
Value
Un nombre qui représente la valeur Unicode de la touche caractère qui a été pressée.
Exemple
>HTML
<p>
Tapez du texte dans la zone ci-dessous pour afficher le <code>charCode</code>.
</p>
<input type="text" />
<p id="log"></p>
JavaScript
const input = document.querySelector("input");
const log = document.querySelector("#log");
input.addEventListener("keypress", (e) => {
log.innerText = `Key pressed: ${String.fromCharCode(e.charCode)}\ncharCode: ${
e.charCode
}`;
});
Résultat
Notes
- Lors d'un évènement
keypress, la valeur Unicode de la touche pressée est stockée soit dans la propriétékeyCodesoit danscharCode, mais jamais dans les deux. Si la touche pressée génère un caractère (par exemple « a »),charCodereçoit le code de ce caractère ;charCoderespecte la casse (autrement dit,charCodetient compte du fait que la touche Maj est enfoncée). Sinon, le code de la touche pressée est stocké danskeyCode. charCoden'est jamais défini lors des évènementskeydownetkeyup. Dans ces cas, c'estkeyCodequi est défini.- Pour obtenir le code de la touche, qu'il soit stocké dans
keyCodeoucharCode, interrogez la propriétéwhich. - Les caractères saisis via un éditeur de méthode de saisie ne sont pas enregistrés via
keyCodeoucharCode. - Pour obtenir la liste des valeurs
charCodeassociées à chaque touche, exécutez Afficher les propriétés de l'objet évènement et consultez le tableau HTML généré.
Spécifications
| Specification |
|---|
| UI Events> # dom-keyboardevent-charcode> |
Compatibilité des navigateurs
Chargement…