The KeyboardEvent.metaKey
read-only property returning a Boolean
that indicates if the Meta key was pressed (true
) or not (false
) when the event occurred. Some operating systems may intercept the key so it is never detected.
Note: On Macintosh keyboards, this is the ⌘ Command key. On Windows keyboards, this is the Windows key (⊞ Windows).
At least as of Firefox 48, the ⊞ Windows key is not considered the "Meta" key. KeyboardEvent.metaKey
is false
when the ⊞ Windows is pressed.
Syntax
var metaKeyPressed = instanceOfKeyboardEvent.metaKey
Return value
A boolean
Example
function ismetaKey(e) { alert("metaKey = " + e.metaKey); }
<button onclick="ismetaKey(event)">Click me with the meta key</button>
Specifications
Specification | Status | Comment |
---|---|---|
Document Object Model (DOM) Level 3 Events Specification The definition of 'KeyboardEvent.metaKey' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Edge | Firefox (Gecko) | Chrome | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Edge | Firefox Mobile (Gecko) | Android | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | ? | ? | ? | ? | ? |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
vonovak,
libbymc,
NicholasBoll,
Makyen,
stan3,
cvrebert,
empirreamm,
Sebastianz,
fscholz,
teoli
Last updated by:
vonovak,