keyCode 229 i klawisze "Unidentified"

keyCode 229 oznacza, że klawisz przejęła klawiatura ekranowa lub metoda wprowadzania (IME). Odczytaj tekst ze zdarzenia input.

Naciśnij go tutaj

Użyj klawiatury telefonu lub mechanizmu wprowadzania tekstu, aby wpisać coś w polu tekstowym

Używasz tylko klawiatury? Naciśnij Esc, a potem Tab, aby wyjść z pola klawiszy.

Której wartości użyć

Gdy keyCode ma wartość 229, nie obsługuj tego zdarzenia jako naciśnięcia konkretnego klawisza. Kod 229 oznacza, że przeglądarka odebrała naciśnięcie za pośrednictwem klawiatury ekranowej lub metody wprowadzania (IME). Metoda wprowadzania ustala tekst i nie podaje, którego klawisza użyto. Na komputerze code może nadal wskazywać fizyczny klawisz, choć ostateczny tekst nie jest jeszcze znany. Wartości zależą od sposobu pisania:

Sposób pisania Wartości w zdarzeniu keydown
Klawiatura Androida key "Unidentified", code "", keyCode 229, isComposing często true
Pisanie po chińsku, japońsku lub koreańsku (IME) key "Process" albo wartość odpowiadająca klawiszowi, code odpowiadający klawiszowi, keyCode 229, isComposing true
Klawiatura iPhone’a lub iPada key odpowiada klawiszowi, code często "", keyCode odpowiada klawiszowi, isComposing false
Klawiatura sprzętowa, bez metody wprowadzania key, code i keyCode odpowiadają klawiszowi, isComposing false

Co sprawia kłopoty

Skróty uruchamiają się, gdy ktoś pisze po japońsku, chińsku lub koreańsku

Klawisze, z których powstaje znak, nadal wysyłają zdarzenia keydown. Pomiń je w obsłudze skrótów, a gotowy tekst odczytaj ze zdarzenia input lub compositionend:

input.addEventListener('keydown', (event) => {
  if (event.isComposing || event.keyCode === 229) return;
  // twoje skróty
});

input.addEventListener('beforeinput', (event) => {
  // event.inputType: 'insertText', 'deleteContentBackward', 'insertLineBreak', ...
  // event.data: dodawany tekst albo null
  // Blokuje tylko wpisywane znaki niebędące cyframi: wklejanie, przeciąganie i kompozycja
  // idą inną drogą, więc sprawdź wartość pola jeszcze raz w input lub change.
  if (event.inputType === 'insertText' && /\D/.test(event.data ?? '')) {
    event.preventDefault();
  }
});

Sprawdzaj obie wartości: Safari wysyła Enter, który zatwierdza znak, z isComposing false, ale z keyCode 229.

Każdy klawisz w telefonie z Androidem to "Unidentified"

Gboard, SwiftKey i inne klawiatury Androida wysyłają większość klawiszy jako keyCode 229 i event.key "Unidentified". Niektóre zwracają wartości odpowiadające klawiszom Backspace lub Enter, ale zależy to od klawiatury i wersji, a część dotknięć dociera w ogóle bez keydown. Nie odczytuj tam klawiszy: odczytuj inputType i data ze zdarzenia beforeinput lub input. Usunięcie znaku ma inputType "deleteContentBackward" i data null.

preventDefault() w keydown nie zatrzymuje tekstu

Tekst nie pochodzi z keydown, więc jego anulowanie nic nie zmienia. Zamiast tego anuluj zdarzenie beforeinput, tak jak w przykładzie. Jest jeden wyjątek: gdy klawiatura składa słowo (inputType "insertCompositionText"), Chrome i Firefox nie pozwalają tego anulować. Popraw wartość pola w zdarzeniu input albo przy compositionend.

event.code jest pusty w iPhonie

Na iPhonie i iPadzie event.key i keyCode zwykle odpowiadają naciśniętemu klawiszowi, ale event.code często jest pustym ciągiem (""). Klawisze ekranowe rozpoznawaj przez event.key.

Działa z klawiaturą USB, ale nie z klawiaturą na ekranie

Klawiatura sprzętowa podłączona do telefonu wysyła zwykłe wartości klawiszy (o ile nie działa metoda wprowadzania), więc testowanie z nią ukrywa problem. Testuj na klawiaturze ekranowej albo skorzystaj z testu powyżej.