Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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

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

js
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é keyCode soit dans charCode, mais jamais dans les deux. Si la touche pressée génère un caractère (par exemple « a »), charCode reçoit le code de ce caractère ; charCode respecte la casse (autrement dit, charCode tient compte du fait que la touche Maj est enfoncée). Sinon, le code de la touche pressée est stocké dans keyCode.
  • charCode n'est jamais défini lors des évènements keydown et keyup. Dans ces cas, c'est keyCode qui est défini.
  • Pour obtenir le code de la touche, qu'il soit stocké dans keyCode ou charCode, interrogez la propriété which.
  • Les caractères saisis via un éditeur de méthode de saisie ne sont pas enregistrés via keyCode ou charCode.
  • Pour obtenir la liste des valeurs charCode associé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