Caps Lockキーのキーコード
Caps Lockは、event.key「CapsLock」、event.code「CapsLock」、keyCode 20を送ります。
すべての値の一覧
| キー | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Caps Lock | CapsLock | CapsLock | 20 | 0(標準) |
keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。
ここで押してみる
ここをクリックしてから、Caps Lockを押してください
キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。
Caps Lockに反応するコード
document.addEventListener('keydown', (event) => {
if (event.key === 'CapsLock') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'CapsLock') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 20) {
// ここに処理を書きます
}
});どの値を使うか
Caps Lockがオンかどうかを知るには、キーを見張らないでください。どのキーイベントやマウスイベントでもよいので、event.getModifierState('CapsLock')を調べます。オンの間はtrueになります。ページを読み込む前からCaps Lockがオンだった場合でも使えます。
キーそのものに反応するには、event.key === 'CapsLock'を確かめます(event.codeも同じです)。keyCodeは20ですが、非推奨です。
Caps Lockは、文字キーのevent.keyを変えます(「a」ではなく「A」)が、event.codeやkeyCodeは変えません。
よくあるつまずき
「Caps Lockがオン」の警告が間違っている
Caps Lockを押した回数を数える方法では、ページを開く前からオンだったときに、すぐ間違えてしまいます。代わりに、パスワード欄のイベントごとに状態を読み取ってください。
function checkCaps(event) {
warning.hidden = !event.getModifierState('CapsLock');
}
password.addEventListener('keydown', checkCaps);
password.addEventListener('keyup', checkCaps);
blurで警告を隠してください。状態がわかるのは、ユーザーがキーを押すかマウスを動かしてからです。ページを読み込んだ時点で調べる方法はありません。
MacではCaps Lockがイベントを1つしか送らない
WindowsやLinuxでは、Caps Lockもほかのキーと同じようにkeydownとkeyupを送ります。Macでは、ChromeとSafariは、オンになるときにkeydownだけを、オフになるときにkeyupだけを送ります。MacのFirefoxは、毎回keydownだけを送ります。そのため、上の警告では両方のイベントを受け取っています。
Caps Lock自体のイベントで読んだ状態が古い
Caps Lock自体のイベントの中で、getModifierStateがもう新しい状態を表しているかどうかは、ブラウザによって違います。次のキーか、keyupでもう一度確かめてください。
軽く押してもオンにならない(Mac)
macOSは、Caps Lockをとても短く押しただけでは無視します。触れただけでオンにならないようにするためです。ランプが消えたままでも、ページにはイベントが届くことがあります。イベントの回数ではなく、getModifierStateを信じてください。
スマホではCaps Lockがオンだと伝わらない
画面のキーボードには、独自の大文字ロック(Shiftを2回タップ)があります。これはCaps Lockのイベントを送らず、getModifierState('CapsLock')もfalseのままです。Caps Lockを伝えるのは物理キーボードだけです。
ゲームやショートカットでのCaps Lock
Caps Lockを押し続けて使うキーにしないでください。Macでは、押している間にkeyupが届きません。また、Caps LockをCtrlやEscに割り当て直している人もいて、その場合ページにはそのキーが届きます。MacのSafariは、パスワード欄に独自のCaps Lockの記号を表示するため、そこでは警告が2つ出ることがあります。