Space 키 코드

스페이스바는 event.key로 " "(공백 하나), event.code로 "Space", keyCode로 32를 보내요.

모든 값 한눈에 보기

Space의 값
키event.codeevent.keykeyCodeevent.location
SpaceSpace" "320(일반)

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

여기서 눌러 보기

여기를 클릭한 뒤 Space 키를 누르세요

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

Space 키에 반응하는 코드

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

어떤 값을 쓸까요

event.key === ' '를 확인하세요. 공백 하나가 든 문자열이에요. event.key === 'Space'는 절대 true가 되지 않아요. key는 키가 입력하는 글자이고, 스페이스바는 공백을 입력하기 때문이에요.

event.code === 'Space'는 누른 키가 스페이스바인지 확인하는 조건이에요. 키의 위치가 중요한 게임과 단축키에 쓰세요. 어떤 배열에서도 같아요.

keyCode는 모든 브라우저에서 공백 문자의 코드와 같은 32이지만 더 이상 권장하지 않아요. Internet Explorer와 Firefox 36 이하는 key로 "Spacebar"를 보냈어요. 그 버전을 아직 지원할 때만 받으세요.

자주 막히는 부분

Space를 누르면 페이지가 스크롤돼요

포커스를 가진 요소가 쓰지 않으면 Space는 한 화면 아래로, Shift + Space는 위로 스크롤해요. 스크롤이 시작되는 keydown에서 막으세요. 입력란은 건드리지 마세요. 그러지 않으면 아무도 공백을 입력할 수 없어요.

if (event.code === 'Space' && !event.target.closest('input, textarea, [contenteditable]')) {
  event.preventDefault();
}

Space가 아직 포커스가 있는 버튼을 눌러요

버튼을 클릭하면 그 버튼이 포커스를 유지하고, Space가 그 버튼을 다시 눌러요. Space로 점프하는 게임이 다시 시작되거나 일시 정지될 수 있어요. 포커스를 옮기거나(button.blur()), 게임이 도는 동안 Space에서 preventDefault()를 호출하세요.

버튼은 keydown이 아니라 keyup에서 동작해요

버튼은 Enter를 누르는 순간 반응하지만 Space는 뗄 때 반응해요. Space를 누르고 있어도 클릭이 반복되지 않아요. 직접 만든 role="button" 요소가 키를 처리한다면 똑같이 하세요. Enter는 keydown, Space는 keyup이에요.

일본어나 중국어를 입력할 때 Space로 단어를 골라요

일본어나 중국어 입력기에서는 발음을 입력한 뒤 Space를 눌러 변환할 글자나 단어를 골라요. 핸들러에는 isComposing이 true이거나 keyCode가 229인 이벤트로 보여요. 이런 이벤트는 건너뛰세요.

if (event.isComposing || event.keyCode === 229) return;

핸들러는 key가 “ “인데 화면에는 아무것도 없어요

정상이에요. 값이 정말 공백 하나라서 출력하면 빈 것처럼 보여요. JSON.stringify(event.key)를 로그로 찍으면 " "가 보여요.

휴대폰의 Space

안드로이드 키보드는 대부분의 키처럼 스페이스바에도 keyCode 229와 key "Unidentified"를 보내는 경우가 많아요. 입력란에 공백을 입력했는지 알아보려면 input 이벤트에서 event.data === ' '인지 확인하세요.