JavaScript detecting key combinations

โœ๏ธ

Detecting a combination of key presses in Vanilla JavaScript

16 Apr, 2021 ยท 3 min read

The other day we built this cool tool to detect which key was pressed. And as you may have seen, it could only register one key at a time.

Today I want to look at how we can capture some combination of keys.

This version will be based on only modifier keys and one specific key.

The modifiers keys we get:

  • metaKey
  • ctrlKey
  • altKey
  • shiftKey

Although we can't combine the regular letters, we can make a combination of these modifier keys.

For instance: metaKey + altKey + d

Detecting key combinations in JavaScript

We don't need to change much in our existing codebase from our normal key detection example.

On the KeyBoardEvent, we get specific data, including the boolean status of the four modifiers keys.

Check out this example where I pressed Shift + Meta + f.

Meta key combination

So let's first convert our HTML to have all the options available.

<body class="mx-auto my-auto bg-gray-100">
  <div class="max-w-md px-8 py-4 my-20 bg-white rounded-lg shadow-lg">
    <div>
      <p class="text-gray-600" id="info">
        Press a key combi to see the magic ๐Ÿช„
      </p>
      <div id="keys" class="flex hidden">
        <div id="meta" class="hidden p-2 mx-2 border-2">Meta</div>
        <div id="ctrl" class="hidden p-2 mx-2 border-2">Ctrl</div>
        <div id="shift" class="hidden p-2 mx-2 border-2">Shift</div>
        <div id="alt" class="hidden p-2 mx-2 border-2">Alt</div>
        <div id="key" class="p-2 mx-2 border-2">Key</div>
      </div>
    </div>
  </div>
</body>

As you can see, I decided to add all the options and the one key, but they were all hidden at first.

We then need to define all these variables in JavaScript.

const key = document.getElementById('key'),
  keys = document.getElementById('keys'),
  info = document.getElementById('info'),
  meta = document.getElementById('meta'),
  ctrl = document.getElementById('ctrl'),
  shift = document.getElementById('shift'),
  alt = document.getElementById('alt');

And as before, we want to listen to the keyDown event.

document.onkeydown = function (e) {
  // Function here
});

We want to check that it is a combination call, not just the first hit on one of the modifier keys.

if (
  (!e.altKey && !e.ctrlKey && !e.metaKey && !e.shiftKey) ||
  e.key === 'Meta' ||
  e.key === 'Shift' ||
  e.key === 'Control' ||
  e.key === 'alt'
) {
  return;
}

If that's the case, we return the function to stop it.

If not, we have a key combination and can show the appropriate keys.

e.altKey ? alt.classList.remove('hidden') : alt.classList.add('hidden');
e.shiftKey ? shift.classList.remove('hidden') : shift.classList.add('hidden');
e.metaKey ? meta.classList.remove('hidden') : meta.classList.add('hidden');
e.ctrlKey ? ctrl.classList.remove('hidden') : ctrl.classList.add('hidden');
info.classList.add('hidden');
keys.classList.remove('hidden');
key.innerHTML = e.keyCode;

The above section will show or hide the modifier keys, and eventually, we will also add the specific key.

You might see in the demo below that it will show up as a weird character if you have certain combinations. The key code, however, will always be the same!

See the Pen JavaScript detecting key combinations by Chris Bongers (@rebelchris) on CodePen.

Thank you for reading, and let's connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Spread the knowledge with fellow developers on Twitter
Tweet this tip
Powered by Webmentions - Learn more

Read next ๐Ÿ“–

JavaScript sending data between windows

9 Sep, 2022 ยท 4 min read

JavaScript sending data between windows

Using the native payment request JavaScript API

9 Aug, 2022 ยท 8 min read

Using the native payment request JavaScript API