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
| Tecla | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| F1 | F1 | F1 | 112 | 0 (Padrão) |
| F2 | F2 | F2 | 113 | 0 (Padrão) |
| F3 | F3 | F3 | 114 | 0 (Padrão) |
| F4 | F4 | F4 | 115 | 0 (Padrão) |
| F5 | F5 | F5 | 116 | 0 (Padrão) |
| F6 | F6 | F6 | 117 | 0 (Padrão) |
| F7 | F7 | F7 | 118 | 0 (Padrão) |
| F8 | F8 | F8 | 119 | 0 (Padrão) |
| F9 | F9 | F9 | 120 | 0 (Padrão) |
| F10 | F10 | F10 | 121 | 0 (Padrão) |
| F11 | F11 | F11 | 122 | 0 (Padrão) |
| F12 | F12 | F12 | 123 | 0 (Padrão) |
| F13 | F13 | F13 | 124 | 0 (Padrão) |
| F14 | F14 | F14 | 125 | 0 (Padrão) |
| F15 | F15 | F15 | 126 | 0 (Padrão) |
| F16 | F16 | F16 | 127 | 0 (Padrão) |
| F17 | F17 | F17 | 128 | 0 (Padrão) |
| F18 | F18 | F18 | 129 | 0 (Padrão) |
| F19 | F19 | F19 | 130 | 0 (Padrão) |
| F20 | F20 | F20 | 131 | 0 (Padrão) |
| F21 | F21 | F21 | 132 | 0 (Padrão) |
| F22 | F22 | F22 | 133 | 0 (Padrão) |
| F23 | F23 | F23 | 134 | 0 (Padrão) |
| F24 | F24 | F24 | 135 | 0 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'F1') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'F1') {
// Seu código aqui
}
});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.