글자 키 코드 (A–Z)
글자 키는 event.code로 "KeyA"~"KeyZ"를 보내요. event.key는 영문(US) 배열에서 "a"~"z"(Shift를 누르거나 Caps Lock을 켜면 "A"~"Z"), keyCode는 65~90이에요.
모든 값 한눈에 보기
| 키 | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| A | KeyA | a | 65 | 0(일반) |
| B | KeyB | b | 66 | 0(일반) |
| C | KeyC | c | 67 | 0(일반) |
| D | KeyD | d | 68 | 0(일반) |
| E | KeyE | e | 69 | 0(일반) |
| F | KeyF | f | 70 | 0(일반) |
| G | KeyG | g | 71 | 0(일반) |
| H | KeyH | h | 72 | 0(일반) |
| I | KeyI | i | 73 | 0(일반) |
| J | KeyJ | j | 74 | 0(일반) |
| K | KeyK | k | 75 | 0(일반) |
| L | KeyL | l | 76 | 0(일반) |
| M | KeyM | m | 77 | 0(일반) |
| N | KeyN | n | 78 | 0(일반) |
| O | KeyO | o | 79 | 0(일반) |
| P | KeyP | p | 80 | 0(일반) |
| Q | KeyQ | q | 81 | 0(일반) |
| R | KeyR | r | 82 | 0(일반) |
| S | KeyS | s | 83 | 0(일반) |
| T | KeyT | t | 84 | 0(일반) |
| U | KeyU | u | 85 | 0(일반) |
| V | KeyV | v | 86 | 0(일반) |
| W | KeyW | w | 87 | 0(일반) |
| X | KeyX | x | 88 | 0(일반) |
| Y | KeyY | y | 89 | 0(일반) |
| Z | KeyZ | z | 90 | 0(일반) |
keyCode는 Windows의 Chrome과 Edge가 보내는 값이에요. Mac 열(Mac의 Chrome과 Safari)과 Firefox 열에는 값이 다를 때만 표시돼요. 일부 키는 운영체제에 따라서도 값이 달라요. 아래 설명을 참고하세요. event.which는 항상 keyCode와 같은 값이에요. event.key는 Shift 없는 미국 배열 기준이에요.
여기서 눌러 보기
여기를 클릭한 뒤 글자 키를 누르세요
키보드만 쓰나요? Esc를 누른 뒤 Tab을 눌러 키 상자에서 나오세요.
A 키에 반응하는 코드
document.addEventListener('keydown', (event) => {
if (event.key === 'a') {
// 여기에 내 코드
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'KeyA') {
// 여기에 내 코드
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 65) {
// 여기에 내 코드
}
});어떤 값을 쓸까요
글자가 중요한지, 키보드에서의 위치가 중요한지에 따라 달라요.
입력한 글자나 Ctrl + Z(실행 취소)처럼 글자 이름이 붙은 단축키는 event.key를 확인하세요. 사용자의 배열을 따라가서 Z가 적힌 키에서 단축키가 동작해요.
게임의 WASD처럼 위치로 정하는 키는 event.code를 확인하세요. KeyW는 프랑스어 AZERTY 키보드에서 “z”가 입력되는 키여도, 어떤 배열에서든 S 위에 있는 키예요.
keyCode는 대문자의 번호예요. A는 65, Z는 90이고 Shift와 상관없어요. 라틴 문자 배열에서는 보통 입력된 글자를 따라가요. AZERTY에서 KeyQ 코드의 키는 “a”를 입력하고 65를 보내요. 러시아어, 그리스어 같은 비라틴 배열에서는 보통 영문(US) 배열의 같은 자리에 있는 글자의 keyCode 값이 나와요.
자주 막히는 부분
event.key가 “a”가 아니라 “A”예요
Shift와 Caps Lock은 event.key를 바꿔요. event.key.toLowerCase() === 'a'처럼 소문자로 비교하고, Shift가 중요하면 event.shiftKey를 따로 확인하세요. Cmd + Shift + Z가 소문자 “z”로 도착하는 Mac에서도 도움이 돼요.
프랑스어 키보드에서 WASD 조작이 안 돼요
event.key === 'w'로 확인하면 AZERTY 플레이어는 왼쪽 아래의 W를 눌러야 해요. event.code(KeyW, KeyA, KeyS, KeyD)를 확인하면 키 위치가 그대로예요. 도움말에 맞는 글자를 보여 주려면 Chrome과 Edge에서 navigator.keyboard.getLayoutMap()으로 코드가 입력하는 글자를 알 수 있어요.
독일어나 프랑스어 키보드에서 Ctrl+Z가 다른 키에 걸려요
독일어 QWERTZ는 Z와 Y가 바뀌어 있고, AZERTY에서는 Z가 US 키보드의 W 자리에 있어요. event.code === 'KeyZ'로 확인한 단축키는 독일 사용자가 Y가 적힌 키를 눌러야 해요. 글자 단축키는 event.key로 맞추세요.
러시아어나 그리스어 배열에서 단축키가 안 돼요
이 배열에서 event.key는 해당 문자예요. 러시아어 배열의 Ctrl + Z는 “я”를 보내요. event.key가 영문자가 아니면 event.code로 키의 위치를 확인하세요.
const letter = /^[a-z]$/i.test(event.key)
? event.key.toLowerCase()
: event.code.startsWith('Key') ? event.code.slice(3).toLowerCase() : '';Mac에서 Alt+글자가 문자를 입력해요
Option + S는 “ß”를 입력해서 event.key가 “s”가 아니라 “ß”예요. Option + E는 데드 키여서 event.key가 “Dead”이고 다음 글자에 악센트가 붙어요. Alt 단축키는 event.code와 event.altKey로 맞추세요. Windows에서도 AltGr이 있는 배열은 Ctrl + Alt로 같은 일이 생겨요. 독일어 키보드에서 Ctrl + Alt + E는 €를 입력하니 Ctrl + Alt + 글자 단축키는 피하세요.