Código da tecla Meta (tecla Windows e Command)
A tecla Windows e a Cmd enviam event.key "Meta". O keyCode é 91 na tecla esquerda, mas a tecla direita e o Firefox no Mac são diferentes.
Todos os valores de relance
| Tecla | event.code | event.key | keyCode | keyCode no Mac | event.location |
|---|---|---|---|---|---|
| Windows esquerdo / Command esquerdo | MetaLeft | Meta | 91 | 1 (Lado esquerdo) | |
| Windows direito / Command direito | MetaRight | Meta | 92 | 93 | 2 (Lado direito) |
keyCode como o Chrome e o Edge enviam no Windows. A coluna do Mac (Chrome e Safari no Mac) e a do Firefox mostram só os números diferentes; algumas teclas também mudam conforme o sistema, como diz o texto abaixo. event.which é sempre o mesmo número do keyCode. event.key vale para um layout dos EUA sem Shift.
Pressione aqui
Clique aqui e pressione a tecla Windows ou Cmd
Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.
Código para reagir a Windows esquerdo
document.addEventListener('keydown', (event) => {
if (event.key === 'Meta') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'MetaLeft') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 91) {
// Seu código aqui
}
});Qual valor usar
Para atalhos no Mac, verifique event.metaKey no keydown da outra tecla. Ele é verdadeiro enquanto a Cmd (ou a tecla Windows) está pressionada. Combine com ctrlKey para atalhos que devem funcionar nos dois sistemas.
Para reagir à própria tecla, verifique event.key === 'Meta' ou event.code: MetaLeft ou MetaRight. Os mesmos nomes valem para a tecla Windows, para a tecla command do Mac e para a tecla Super do Linux.
Não use keyCode para essa tecla. A tecla esquerda é 91, mas o Firefox no Mac envia 224 para as duas, o Firefox no Windows e no Linux envia 91 para as duas, e a tecla direita é 92 no Windows e 93 no Chrome e no Safari do Mac.
O que costuma dar errado
No Mac, o keyup nunca chega para teclas apertadas com a Cmd pressionada
O macOS não envia o keyup das teclas apertadas enquanto a Cmd está pressionada: aperte Cmd + K, solte o K, e a página não recebe o keyup do K. Os navegadores não conseguem corrigir isso por completo, porque o macOS não informa a liberação. Não acompanhe o estado das teclas pressionadas durante atalhos com Cmd. Quando o keyup da Meta chegar, marque como soltas as teclas apertadas enquanto a Cmd estava pressionada.
O keyCode 93 significa duas teclas diferentes
No Windows, 93 é a tecla de menu (event.code “ContextMenu”). No Chrome e no Safari do Mac, 93 é a tecla Cmd direita. Use event.code para saber qual delas chegou.
A tecla Windows abre o menu Iniciar
A tecla Windows sozinha abre o Iniciar, e atalhos do Windows como Windows + D, Windows + L ou Windows + Tab vão para o sistema. A página não pode impedi-los. O Iniciar fica com o foco, então keyups podem se perder: zere as teclas pressionadas no evento blur da janela. Não crie atalhos com a tecla Windows.
Versões antigas do Firefox enviam “OS” e “OSLeft”
O Firefox anterior à versão 118 enviava event.key “OS” para a tecla Windows e event.code “OSLeft” e “OSRight”. O Chrome usava “OSLeft” e “OSRight” antes da versão 52. Os navegadores atuais enviam "Meta", "MetaLeft" e "MetaRight". Verifique os nomes antigos só se você der suporte a essas versões.
Atalhos com Cmd no Mac
Usuários de Mac esperam a Cmd onde o Windows usa Ctrl: Cmd + S para salvar, Cmd + Z para desfazer, Cmd + Shift + Z para refazer. Aceite event.ctrlKey || event.metaKey e escreva o atalho como Cmd + S ou ⌘S no Mac. Cmd + N, Cmd + T, Cmd + W e Cmd + Q pertencem ao navegador e nunca chegam à página.