MouseEvent: metaKey プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

MouseEvent.metaKey は読み取り専用のプロパティでありマウスイベントが発行されたときに meta キーが押されていたかどうかを論理値で示します。

多くのオペレーティングシステムでは、 meta キーに特殊な機能を割り当てているため、このプロパティは実際にはキーが押されていても false を返す可能性があることに注意してください。 例えば、 Windows では、このキーはスタートメニューを開きます。

メモ: Macintosh のキーボードでは、このキーは command キー (⌘) です。 Windows のキーボードでは、このキーは Windows キー (⊞) です。

値

論理値であり、 true はキーが押されていたことを、 false はキーが押されていなかったことを示します。

例

この例は、 click イベントが発行されたときに metaKey プロパティを記録します。

HTML

html
<p>
  <code>metaKey</code> プロパティを試験するためにどこかをクリックしてください。
</p>
<p id="log"></p>

JavaScript

js
let log = document.querySelector("#log");
document.addEventListener("click", logKey);

function logKey(e) {
  log.textContent = `Meta キーの押下状態: ${e.metaKey}`;
}

結果

仕様書

Specification
UI Events
# dom-mouseevent-metakey

ブラウザーの互換性

BCD tables only load in the browser

関連情報