keyCode 229と「Unidentified」のキー
keyCode 229は、画面のキーボードかIMEがキーを受け取ったという意味です。代わりにinputイベントからテキストを読み取ってください。
ここで押してみる
スマホのキーボードかIMEで、入力欄に入力してください
キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。
どの値を使うか
keyCodeが229のときは、そのキーに反応しないでください。229はキーではありません。ブラウザが、画面のキーボードかIME(日本語入力などの入力システム)を通してキー入力を受け取ったという意味です。画面のキーボードやIMEは入力する文字を自分で決め、どのキーだったかを伝えません(パソコンのIMEでは、codeが物理的なキーを表すこともありますが、テキストはまだ決まっていません)。届く値は、ユーザーの入力方法によって変わります。
| 入力方法 | keydownで届く値 |
|---|---|
| Androidのキーボード | keyは「Unidentified」、codeは”“、keyCodeは229、isComposingはtrueのことが多い |
| 日本語・中国語・韓国語の入力(IME) | keyは「Process」か本当のキー、codeは本当のキー、keyCodeは229、isComposingはtrue |
| iPhoneやiPadのキーボード | keyは本当のキー、codeは”“のことが多い、keyCodeは本当の数値、isComposingはfalse |
| 物理キーボード(IMEなし) | key、code、keyCodeはすべて本当の値、isComposingはfalse |
よくあるつまずき
日本語・中国語・韓国語の入力中にショートカットが動いてしまう
文字を組み立てるためのキーも、keydownイベントを送ります。ショートカットの処理ではこれらを飛ばし、確定したテキストはinputイベントかcompositionendイベントから読み取ってください。
input.addEventListener('keydown', (event) => {
if (event.isComposing || event.keyCode === 229) return;
// ここにショートカットの処理
});
input.addEventListener('beforeinput', (event) => {
// event.inputType: 'insertText', 'deleteContentBackward', 'insertLineBreak', ...
// event.data: 追加されるテキスト、または null
// 止めるのは入力された数字以外の文字だけ。貼り付け、ドロップ、変換は別の経路で入るので、
// input や change でも入力欄の値を確かめる。
if (event.inputType === 'insertText' && /\D/.test(event.data ?? '')) {
event.preventDefault();
}
});
両方の値を確かめてください。Safariは、文字を確定するEnterを、isComposingがfalseでkeyCodeが229の状態で送ります。
Androidスマホでは、どのキーも「Unidentified」になる
GboardやSwiftKeyなどのAndroidのキーボードは、ほとんどのキーをkeyCode 229、event.key「Unidentified」として送ります。BackspaceやEnterだけ本当のキーを送るものもありますが、キーボードやバージョンによって違い、keydownがまったく来ないタップもあります。ここではキーを読み取らず、beforeinputかinputのinputTypeとdataを読み取ってください。削除のときは、inputTypeが「deleteContentBackward」、dataがnullになります。
keydownでpreventDefault()を呼んでもテキストが止まらない
テキストはkeydownから入力されるわけではないので、keydownを取り消しても何も変わりません。上の例のように、代わりにbeforeinputイベントを取り消してください。例外が1つあります。キーボードが単語を変換している間(inputTypeが「insertCompositionText」)は、ChromeとFirefoxでは取り消せません。inputイベントかcompositionendの時点で、入力欄の値を直してください。
iPhoneでevent.codeが空になる
iPhoneやiPadは、たいてい本当のevent.keyとkeyCodeを送りますが、event.codeは”“のことがよくあります。画面のキーボードのキーはevent.keyで判定してください。
USBキーボードでは動くのに、画面のキーボードでは動かない
スマホにつないだ物理キーボードは、IMEがオンでなければ本当のキーを送ります。そのため、物理キーボードでテストすると問題が隠れてしまいます。画面のキーボードでテストするか、上の「ここで押してみる」で確かめてください。