Caps Lockキーのキーコード

Caps Lockは、event.key「CapsLock」、event.code「CapsLock」、keyCode 20を送ります。

すべての値の一覧

Caps Lockの値
キーevent.codeevent.keykeyCodeevent.location
Caps LockCapsLockCapsLock200(標準)

keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。

ここで押してみる

ここをクリックしてから、Caps Lockを押してください

キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。

Caps Lockに反応するコード

おすすめ:event.keyで判定
document.addEventListener('keydown', (event) => {
  if (event.key === 'CapsLock') {
    // ここに処理を書きます
  }
});
キーの位置で判定:event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'CapsLock') {
    // ここに処理を書きます
  }
});
keyCodeを使う古いコード(非推奨)
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つ出ることがあります。