Ctrlキーのキーコード
どちらのCtrlキーもevent.key「Control」とkeyCode 17を送ります。左右を見分けられるのはevent.codeとevent.locationだけです。
すべての値の一覧
| キー | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| 左Ctrl | ControlLeft | Control | 17 | 1(左側) |
| 右Ctrl | ControlRight | Control | 17 | 2(右側) |
keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。
ここで押してみる
ここをクリックしてから、Controlを押してください
キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。
左Ctrlに反応するコード
document.addEventListener('keydown', (event) => {
if (event.key === 'Control') {
// ここに処理を書きます
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'ControlLeft') {
// ここに処理を書きます
}
});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 }で登録してください。