화살표 키 코드

화살표 키는 event.key "ArrowLeft", "ArrowUp", "ArrowRight", "ArrowDown"과 keyCode 37, 38, 39, 40을 보내요.

모든 값 한눈에 보기

화살표 키의 값
키event.codeevent.keykeyCodeevent.location
왼쪽 화살표ArrowLeftArrowLeft370(일반)
위쪽 화살표ArrowUpArrowUp380(일반)
오른쪽 화살표ArrowRightArrowRight390(일반)
아래쪽 화살표ArrowDownArrowDown400(일반)

keyCode는 Windows의 Chrome과 Edge가 보내는 값이에요. Mac 열(Mac의 Chrome과 Safari)과 Firefox 열에는 값이 다를 때만 표시돼요. 일부 키는 운영체제에 따라서도 값이 달라요. 아래 설명을 참고하세요. event.which는 항상 keyCode와 같은 값이에요. event.key는 Shift 없는 미국 배열 기준이에요.

여기서 눌러 보기

여기를 클릭한 뒤 화살표 키를 누르세요

키보드만 쓰나요? Esc를 누른 뒤 Tab을 눌러 키 상자에서 나오세요.

왼쪽 화살표 키에 반응하는 코드

권장: event.key로 구분
document.addEventListener('keydown', (event) => {
  if (event.key === 'ArrowLeft') {
    // 여기에 내 코드
  }
});
키의 위치로 구분: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ArrowLeft') {
    // 여기에 내 코드
  }
});
keyCode를 쓰는 예전 코드(사용 비권장)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 37) {
    // 여기에 내 코드
  }
});

어떤 값을 쓸까요

event.key를 확인하세요. 화살표 키는 자판 배열이 바뀌어도 그대로여서 key와 code의 이름이 같아요. ArrowLeft, ArrowUp, ArrowRight, ArrowDown이에요.

숫자패드를 제외해야 한다면 event.code를 쓰세요. Num Lock이 꺼져 있으면 숫자패드의 4, 8, 6, 2 키도 key “ArrowLeft”, “ArrowUp”, “ArrowRight”, “ArrowDown”과 keyCode 37~40을 보내요. 이때는 code(Numpad4, Numpad8, Numpad6, Numpad2)와 location 3으로만 구분돼요.

예전 번호는 왼쪽부터 시계 방향이에요. 37 왼쪽, 38 위, 39 오른쪽, 40 아래예요. 모든 브라우저가 지금도 보내지만 더 이상 권장하지 않는 값이에요.

자주 막히는 부분

화살표 키를 누르면 페이지가 스크롤돼요

스크롤은 화살표 키의 기본 동작이에요. keydown에서 event.preventDefault()를 호출하세요. window 대신 게임 요소 자체에 리스너를 다세요(tabindex="0"을 지정하세요). 그래야 페이지의 나머지 부분은 계속 스크롤되고 입력란에서도 커서가 움직여요.

game.addEventListener('keydown', (event) => {
  if (event.key.startsWith('Arrow')) event.preventDefault();
});

움직임이 끊기거나 방향이 고정돼요

키를 누르고 있으면 keydown이 한 번 오고, 잠깐 멈췄다가, 사용자가 정한 반복 속도로 계속 와요. keydown마다 움직이면 끊겨 보여요. 대신 눌린 키 목록을 만드세요. keydown에서 event.code를 추가하고 keyup에서 지운 뒤, 게임 루프에서 움직이면 돼요. 창의 blur 이벤트에서는 목록을 비우세요. 키를 누른 채 다른 창으로 옮기면 keyup이 페이지에 오지 않아요.

예전 코드가 “Left”나 “Up”을 확인해요

Internet Explorer, Edge 16 이하, Firefox 36 이하는 "Left", "Up", "Right", "Down"을 보냈어요. 요즘 브라우저는 Arrow가 붙은 이름을 보내요. 그런 브라우저를 아직 지원해야 할 때만 둘 다 확인하세요.

화살표 처리 코드가 슬라이더, 목록, 입력란과 충돌해요

많은 요소가 화살표 키를 직접 써요. 입력란은 커서를 옮기고, 슬라이더는 값을 바꾸고, 라디오 버튼과 <select>는 선택을 바꿔요. event.target이 이런 요소이면 건너뛰거나, 요소가 먼저 키를 처리하게 한 뒤 event.defaultPrevented를 확인하세요.

Mac과 노트북 키보드

Mac 노트북과 작은 키보드 중에는 Home, End, Page Up, Page Down 키가 없는 것이 많아요. Mac에서는 화살표 키와 Fn을 함께 누르세요. Fn + 왼쪽은 Home, Fn + 오른쪽은 End, Fn + 위는 Page Up, Fn + 아래는 Page Down을 보내요. 이때 페이지에는 화살표가 아니라 그 키가 전달돼요.

Mac에서는 Cmd를 누른 상태에서 화살표 키를 누르면, 어느 브라우저에서든 그 키의 keyup이 오지 않을 수 있어요. 누르고 있는 키 상태를 판단할 때 keyup에 의존하지 마세요.