KeyboardEvent.metaKey
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. This is probably the same for the ⌘ Command key on Macintosh keyboards.
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 | Firefox (Gecko) | Chrome | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Firefox Mobile (Gecko) | Android | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | ? | ? | ? | ? | ? |
See also
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/keyboardevent/metakey