MouseEvent: ctrlKey プロパティ

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.ctrlKey は読み取り専用のプロパティで、このマウスイベントが発生した際に Ctrl キーが押されていたかどうかを示す論理値です。

Macintosh のキーボードでは、このキーは control キーと表記されています。また、 Mac では control キーと組み合わせたクリックは、オペレーティングシステムに拾われてコンテキストメニューを開くのに使われるので、 ctrlKey はクリックイベントで検出されないことに注意してください。

値

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

例

この例では、 mousemove イベントを発生させた際に ctrlKey プロパティを記録します。

HTML

html
<p id="log">カーソルが動いていたときに Ctrl キーが押されていた: false</p>

JavaScript

js
const log = document.querySelector("#log");
window.addEventListener("mousemove", logKey);

function logKey(e) {
  log.textContent = `カーソルが動いていたときに Ctrl キーが押されていた: ${e.ctrlKey}`;
}

結果

仕様書

Specification
UI Events
# dom-mouseevent-ctrlkey

ブラウザーの互換性

BCD tables only load in the browser

関連情報