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.