Metaキーのキーコード(Windowsキーとcommand)

WindowsキーとCmdはevent.key「Meta」を送ります。左のキーのkeyCodeは91ですが、右のキーとMacのFirefoxでは違います。

すべての値の一覧

Windowsキー・command(Meta)の値
キーevent.codeevent.keykeyCodeMacでのkeyCodeevent.location
左Windows / 左commandMetaLeftMeta911(左側)
右Windows / 右commandMetaRightMeta92932(右側)

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

ここで押してみる

ここをクリックしてから、WindowsキーかCmdを押してください

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

左Windowsに反応するコード

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

どの値を使うか

Macのショートカットには、もう一方のキーのkeydownでevent.metaKeyを確かめます。Cmd(またはWindowsキー)が押されている間はtrueになります。両方のシステムで動かしたいショートカットには、ctrlKeyと組み合わせます。

キーそのものに反応するには、event.key === 'Meta'か、event.codeのMetaLeft・MetaRightを確かめます。Windowsキー、Macのcommandキー、LinuxのSuperキーは、どれも同じ名前です。

このキーにはkeyCodeを使わないでください。左のキーは91ですが、MacのFirefoxは両方のキーに224を、WindowsとLinuxのFirefoxは両方に91を送ります。右のキーはWindowsでは92ですが、MacのChromeとSafariでは93です。

よくあるつまずき

Macで、Cmdを押しながら押したキーのkeyupが届かない

macOSは、Cmdを押している間に押したキーのkeyupを送りません。Cmd + Kを押してKを離しても、ページにはKのkeyupが届きません。macOSがキーを離したことを知らせないので、ブラウザも完全には直せません。Cmdのショートカットの間は、押されているキーを追わないでください。Metaのkeyupが届いたら、Cmdを押している間に押されたキーを、離されたものとして扱います。

keyCode 93が2つの別のキーを指す

Windowsでは、93はアプリケーションキー(event.code「ContextMenu」)です。MacのChromeとSafariでは、93は右のCmdキーです。どちらが届いたかはevent.codeで確かめてください。

Windowsキーを押すとスタートメニューが開く

Windowsキーだけを押すとスタートメニューが開きます。Windows + D、Windows + L、Windows + TabなどのWindowsのショートカットはシステムに届きます。ページからは止められません。スタートメニューがフォーカスを取るので、keyupが届かないことがあります。windowのblurイベントで、押されているキーの状態をリセットしてください。Windowsキーでショートカットを作らないでください。

古いFirefoxが「OS」や「OSLeft」を送る

バージョン118より前のFirefoxは、Windowsキーでevent.keyに「OS」、event.codeに「OSLeft」「OSRight」を送っていました。Chromeもバージョン52より前は「OSLeft」「OSRight」でした。今のブラウザは"Meta"、"MetaLeft"、"MetaRight"を送ります。古い名前を確かめるのは、それらのバージョンに対応する場合だけで十分です。

MacのCmdショートカット

Macユーザーは、WindowsでCtrlを使うところでCmdを期待します。Cmd + Sで保存、Cmd + Zで取り消し、Cmd + Shift + Zでやり直しです。event.ctrlKey || event.metaKeyを受け付け、MacではショートカットをCmd + Sか⌘Sと表示してください。Cmd + N、Cmd + T、Cmd + W、Cmd + Qはブラウザのもので、ページには届きません。