MouseEvent: ctrlKey プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
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}`;
}
結果
仕様書
| 仕様書 |
|---|
| Pointer Events # dom-mouseevent-ctrlkey |