Ctrlキーのキーコード

どちらのCtrlキーもevent.key「Control」とkeyCode 17を送ります。左右を見分けられるのはevent.codeとevent.locationだけです。

すべての値の一覧

Controlの値
キーevent.codeevent.keykeyCodeevent.location
左CtrlControlLeftControl171(左側)
右CtrlControlRightControl172(右側)

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

ここで押してみる

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

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

左Ctrlに反応するコード

おすすめ:event.keyで判定
document.addEventListener('keydown', (event) => {
  if (event.key === 'Control') {
    // ここに処理を書きます
  }
});
キーの位置で判定:event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ControlLeft') {
    // ここに処理を書きます
  }
});
keyCodeを使う古いコード(非推奨)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 17) {
    // ここに処理を書きます
  }
});

どの値を使うか

ショートカットには、もう一方のキーのkeydownでevent.ctrlKeyを確かめます。どちらかのCtrlキーが押されている間はtrueになるので、Ctrlの状態を自分で追う必要はありません。

Ctrlそのものに反応するには、event.key === 'Control'を確かめます。どちらのキーもこの値とkeyCode 17を送ります。左右を見分けるには、event.code(ControlLeftかControlRight)かevent.location(1が左、2が右)を使います。ノートパソコンの多くには、右Ctrlがそもそもありません。

Macでは、controlと書かれたキーが同じ値を送ります。ただし、MacのショートカットはCmdを使います。これはctrlKeyではなくmetaKeyです。

よくあるつまずき

ショートカットがWindowsでは動くのにMacでは動かない

Macのユーザーが押すのはCtrl + SではなくCmd + Sです。両方を受け付けてください。

if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') {
  event.preventDefault();
  save();
}

表示するラベルも合わせます。WindowsとLinuxではCtrl + S、MacではCmd + Sか⌘Sです。

AltGrで@や€を入力するとCtrlが発生する

Windowsでは、AltGrはCtrlとAltを同時に押したものとして働きます。ChromeとEdgeは、まず左Ctrlのkeydownを送り、次に右Altを送ります。入力されたキーではctrlKeyとaltKeyがどちらもtrueになります。そのため、ポーランド語のユーザーが「ą」を、ドイツ語のユーザーが「@」を入力しただけで、Ctrl + Alt + 文字キーのショートカットが動いてしまうことがあります。Ctrl + Altのショートカットは避けるか、event.keyが想定した文字と違う文字になっているキーは無視してください。

Ctrl+W、Ctrl+T、Ctrl+N、Ctrl+Tabを止められない

これらはブラウザが使います。WindowsではCtrl + N、Ctrl + T、Ctrl + W、Ctrl + Tab、Ctrl + Page Up、Ctrl + Page Downです。ChromeとEdgeでは、ページにkeydownが届きません。Firefoxはkeydownを送ることがありますが、どのブラウザでもpreventDefault()でブラウザの動作は止められません。別のショートカットを選んでください。Ctrl + S、Ctrl + P、Ctrl + Fはページに届き、preventDefault()でブラウザ自身の動作を止められます。

MacでCtrl+クリックするとメニューが開く

Macでは、control + クリックは右クリックと同じで、ブラウザはcontextmenuを発生させます。Macでは「選択に追加」にCtrl + クリックを使わないでください。Macのアプリと同じように、Cmd + クリック(metaKey)を使います。

Ctrl+スクロールでページが拡大縮小される

Ctrlを押しながらマウスホイールを回すと、ページが拡大縮小されます。トラックパッドのピンチ操作も同じで、Chrome、Edge、FirefoxはこれをCtrl付きのwheelイベントとして送ります。wheelリスナーではctrlKeyがtrueになります。地図やcanvasが独自に拡大縮小する場合だけpreventDefault()を呼び、リスナーは{ passive: false }で登録してください。