MDN self-hosted library · e01.org

KeyboardEvent: ctrlKey property

UI Events

Open notebook · 2 cells web-api-instance-property upstream source

UI Events

The KeyboardEvent.ctrlKey read-only property returns a boolean value that indicates if the control key was pressed (true) or not (false) when the event occurred.

When the Control key itself is pressed or released, this property is true for its keydown event and false for its keyup event, because both events fire after the state change.

Value

A boolean value.

Examples

<p>
  Press any character key, with or without holding down the CTRL key.<br />
  You can also use the SHIFT key together with the CTRL key.
</p>
<pre id="output"></pre>
const output = document.getElementById("output");

function showChar(e) {
  output.textContent = `Key KeyDown: "${e.key}"
CTRL key KeyDown: ${e.ctrlKey}
`;
}

document.addEventListener("keydown", showChar);

Specifications

Browser compatibility

See also

  • KeyboardEvent