Códigos das teclas de função (F1–F24)

F1 a F12 enviam event.key e event.code "F1" a "F12" e keyCode 112 a 123. F13 a F24 continuam de 124 a 135.

Todos os valores de relance

Valores de Teclas de função
Teclaevent.codeevent.keykeyCodeevent.location
F1F1F11120 (Padrão)
F2F2F21130 (Padrão)
F3F3F31140 (Padrão)
F4F4F41150 (Padrão)
F5F5F51160 (Padrão)
F6F6F61170 (Padrão)
F7F7F71180 (Padrão)
F8F8F81190 (Padrão)
F9F9F91200 (Padrão)
F10F10F101210 (Padrão)
F11F11F111220 (Padrão)
F12F12F121230 (Padrão)
F13F13F131240 (Padrão)
F14F14F141250 (Padrão)
F15F15F151260 (Padrão)
F16F16F161270 (Padrão)
F17F17F171280 (Padrão)
F18F18F181290 (Padrão)
F19F19F191300 (Padrão)
F20F20F201310 (Padrão)
F21F21F211320 (Padrão)
F22F22F221330 (Padrão)
F23F23F231340 (Padrão)
F24F24F241350 (Padrão)

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 uma tecla de função

Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.

Código para reagir a F1

Recomendado: identificar por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'F1') {
    // Seu código aqui
  }
});
Identificar pelo lugar da tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'F1') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 112) {
    // Seu código aqui
  }
});

Qual valor usar

Verifique event.key === 'F2' (ou o número que você precisar). Nas teclas de função, event.key e event.code têm o mesmo texto, de “F1” a “F24”, em qualquer layout de teclado. Então você pode usar um ou outro.

O keyCode vai de 112 (F1) a 123 (F12) e segue até 135 (F24). Ele ainda chega, mas está obsoleto. Navegadores antigos no Mac enviavam 0 para F21 a F24 (veja abaixo).

Pense em quem não consegue apertar uma tecla de função com facilidade. Notebooks e teclados de Mac colocam brilho, volume e controles de mídia nessas mesmas teclas. Muitos teclados compactos nem têm a fileira F. Dê a cada atalho de tecla F uma segunda forma de acesso, como um botão ou um atalho com letra.

O que costuma dar errado

F5 recarrega a página e F12 abre as ferramentas do desenvolvedor

O navegador já usa a maioria das teclas de função. No Chrome, no Windows: F1 abre a ajuda, F3 busca, F5 recarrega, F6 vai para a barra de endereço, F7 liga a navegação por cursor, F10 move o foco para a barra de ferramentas, F11 abre a tela cheia e F12 abre as ferramentas do desenvolvedor. Chamar event.preventDefault() no keydown impede muitas delas, como F5, mas não todas. Na tela cheia, o F11 que sai dela nunca chega à página. Não construa nada importante sobre F5, F11 ou F12.

Apertar F5 muda o volume

Em muitos notebooks, a fileira de cima faz primeiro as funções de mídia, e F1 a F12 precisam da tecla Fn. Aí o navegador recebe uma tecla de mídia, como AudioVolumeUp (keyCode 175), ou nada, no caso das teclas de brilho. Muitos notebooks têm um bloqueio do Fn, geralmente Fn + Esc, ou uma configuração que inverte isso. Sua página não pode mudar isso. Peça ao usuário para segurar a tecla Fn.

No Mac, as teclas F mudam a tela e o som

Teclados de Mac enviam brilho, volume e outros controles pela fileira de cima, a menos que o usuário segure fn ou ative “Usar as teclas F1, F2 etc. como teclas de função padrão” nas configurações do teclado. Mesmo assim, o macOS guarda algumas para si: F11 pode mostrar a mesa. Usuários de Mac também esperam atalhos com Cmd, como Cmd + R para recarregar, mais do que teclas F.

Alt+F4 e Ctrl+F4 nunca chegam à página

No Windows, Alt + F4 fecha a janela e Ctrl + F4 fecha a aba no Chrome e no Edge. Elas somem antes de o seu código rodar. Não use essas combinações como atalhos.

F21 a F24 não funcionam no Mac

O macOS não tem teclas acima de F20, e versões antigas do Chrome e do Safari enviavam keyCode 0 para F21 a F24. Não conte com essas teclas no Mac. Teclas acima de F12 existem só em alguns teclados: os teclados completos da Apple vão até F19, e macro pads e teclados gamer costumam enviar F13 a F24, porque nenhum outro app usa essas teclas.