keyCode 229 et touches « Unidentified »

keyCode 229 signifie qu’un clavier à l’écran ou une méthode de saisie a pris la touche en charge ; lisez le texte dans l’événement input.

Appuyez dessus ici

Écrivez dans la zone de texte avec le clavier de votre téléphone ou une méthode de saisie

Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.

Quelle valeur utiliser

Quand keyCode vaut 229, n’agissez pas sur la touche. 229 n’est pas une touche : cela veut dire que le navigateur a reçu l’appui par un clavier à l’écran ou une méthode de saisie (IME), qui décide elle-même du texte et ne dit pas de quelle touche il s’agit (avec une méthode de saisie sur ordinateur, code peut encore nommer la touche physique, mais le texte n’est pas encore décidé). Ce qui arrive dépend de la façon de saisir :

Saisie avec Ce qui arrive sur keydown
Un clavier Android key « Unidentified », code "", keyCode 229, isComposing souvent vrai
Une saisie chinoise, japonaise ou coréenne (IME) key « Process » ou la vraie touche, code la vraie touche, keyCode 229, isComposing vrai
Un clavier d’iPhone ou d’iPad key la vraie touche, code souvent « », keyCode le vrai numéro, isComposing faux
Un clavier physique, sans méthode de saisie key, code et keyCode réels, isComposing faux

Ce qui pose problème

Les raccourcis se déclenchent pendant la saisie en japonais, chinois ou coréen

Les touches qui construisent un caractère envoient quand même des événements keydown. Ignorez-les dans vos gestionnaires de raccourcis, et lisez le texte terminé dans l’événement input ou compositionend :

input.addEventListener('keydown', (event) => {
  if (event.isComposing || event.keyCode === 229) return;
  // your shortcuts
});

input.addEventListener('beforeinput', (event) => {
  // event.inputType: 'insertText', 'deleteContentBackward', 'insertLineBreak', ...
  // event.data: the text being added, or null
  // Blocks typed non-digits only: paste, drop and composition take other paths,
  // so check the field's value again on input or change.
  if (event.inputType === 'insertText' && /\D/.test(event.data ?? '')) {
    event.preventDefault();
  }
});

Vérifiez les deux valeurs : Safari envoie la touche Entrée qui confirme un caractère avec isComposing faux mais keyCode 229.

Chaque touche d’un téléphone Android est « Unidentified »

Gboard, SwiftKey et d’autres claviers Android envoient la plupart des touches avec keyCode 229 et event.key « Unidentified ». Certains envoient une vraie touche Retour arrière ou Entrée, mais cela change selon les claviers et les versions, et certains appuis arrivent sans aucun keydown. Ne lisez pas les touches : lisez inputType et data dans beforeinput ou input. Une suppression a inputType « deleteContentBackward » et data null.

preventDefault() sur keydown n’arrête pas le texte

Le texte ne vient pas du keydown : l’annuler ne change rien. Annulez plutôt l’événement beforeinput, comme dans l’exemple. Une exception : pendant que le clavier compose un mot (inputType « insertCompositionText »), Chrome et Firefox ne permettent pas de l’annuler. Corrigez la valeur du champ dans l’événement input ou à compositionend.

event.code est vide sur un iPhone

Les iPhone et les iPad envoient en général le vrai event.key et le vrai keyCode, mais event.code est souvent "". Repérez les touches à l’écran avec event.key.

Ça marche avec un clavier USB mais pas avec le clavier à l’écran

Un clavier physique sur un téléphone envoie de vraies touches (sauf si une méthode de saisie est active) : un test avec lui cache le problème. Testez avec le clavier à l’écran, ou utilisez la vérification ci-dessus.