← 返回首页

MouseEvent: ctrlKey property - Web APIs | MDN

Toggle sidebar

Theme

OS default
Light
Dark

English (US)

Remember language Learn more

MouseEvent: ctrlKey property

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.

The MouseEvent.ctrlKey read-only property is a boolean value that indicates whether the ctrl key was pressed or not when a given mouse event occurs.

On Macintosh keyboards, this key is labeled the control key. Also, note that on a Mac, a click combined with the control key is intercepted by the operating system and used to open a context menu, so ctrlKey is not detectable on click events.

Pinch-zooming using a trackpad also sends a simulated wheel event with ctrlKey set to true.

In this article

Value

A boolean value, where true indicates that the key is pressed, and false indicates that the key is not pressed.

Examples

This example logs the ctrlKey property when you trigger a mousemove event.

HTML

html

<p id="log">The ctrl key was pressed while the cursor was moving: false</p>

JavaScript

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

function logKey(e) {
  log.textContent = `The ctrl key was pressed while the cursor was moving: ${e.ctrlKey}`;
}

Result

Specifications

Specification

Pointer Events
# dom-mouseevent-ctrlkey

Browser compatibility

Enable JavaScript to view this browser compatibility table.

See also

MouseEvent

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Feb 13, 2026 by MDN contributors.

View this page on GitHub • Report a problem with this content

Pointer events
MouseEvent
Constructor
1. MouseEvent()
Static properties
1. WEBKIT_FORCE_AT_FORCE_MOUSE_DOWN
2. WEBKIT_FORCE_AT_MOUSE_DOWN
Instance properties
Instance methods
1. getModifierState()
2. initMouseEvent()
Inheritance
1. UIEvent
2. Event
Related pages for Pointer Events
Guides