Shift 키 코드

두 Shift 키 모두 event.key로 "Shift", keyCode로 16을 보내요. 왼쪽과 오른쪽은 event.code와 event.location으로만 구분돼요.

모든 값 한눈에 보기

Shift의 값
키event.codeevent.keykeyCodeevent.location
왼쪽 ShiftShiftLeftShift161(왼쪽)
오른쪽 ShiftShiftRightShift162(오른쪽)

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

여기서 눌러 보기

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

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

왼쪽 Shift 키에 반응하는 코드

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

어떤 값을 쓸까요

다른 키를 누를 때 Shift가 눌려 있는지는 event.shiftKey를 확인하세요. 어느 쪽 Shift든 눌려 있는 동안 모든 키 이벤트에서 true라서 Shift 키를 직접 추적할 필요가 없어요.

Shift 자체에 반응하려면 event.key === 'Shift'를 확인하세요. 두 키 모두 keyCode 16과 함께 이 값을 보내요. 두 키가 다른 일을 해야 할 때는 event.code(ShiftLeft 또는 ShiftRight)나 event.location(1이 왼쪽, 2가 오른쪽)을 쓰세요.

Shift 키 자신의 이벤트에서 shiftKey는 keydown에서 true, keyup에서 false예요. 누르거나 뗀 뒤의 상태를 보여 주기 때문이에요.

자주 막히는 부분

Ctrl+Shift+Z가 event.key === ’z’와 맞지 않아요

Shift는 다른 키의 event.key를 바꿔요. “z”는 “Z”가 되고 “1”은 “!“가 돼요. event.code(KeyZ, Digit1)나 keyCode(90, 49)는 바뀌지 않아요. Shift가 들어간 글자 단축키는 소문자로 비교하거나 code를 쓰세요.

if (event.ctrlKey && event.shiftKey && event.key.toLowerCase() === 'z') redo();

Shift+2를 누르면 배열에 따라 골뱅이나 큰따옴표가 입력돼요

Shift + 숫자 키의 기호는 배열에 따라 달라요. Shift + 2는 US 키보드에서 “@”, 영국 키보드에서는 ’“’이고, AZERTY는 숫자를 입력하는 데도 Shift가 필요해요. 단축키가 기호라면 event.key로 기호를 확인하고 shiftKey는 무시하세요. 키 위치라면 event.code를 확인하세요.

두 Shift를 함께 눌렀더니 한쪽이 계속 눌린 상태예요

Windows에서 두 Shift를 모두 누르면 시스템이 뗀 것을 한 번만 알릴 수 있어서 한쪽 Shift의 keyup이 사라질 수 있어요. 양쪽을 따로 추적한다면 어느 Shift의 keyup이 오든 둘 다 해제하거나, 다음 키 이벤트의 event.shiftKey로 상태를 바로잡으세요.

Shift를 누른 채 창이 포커스를 잃었어요

이때 keyup은 다른 창으로 가요. 창의 blur 이벤트에서 Shift 상태를 초기화하거나, 직접 만든 플래그 대신 다음 키 또는 마우스 이벤트의 event.shiftKey를 믿으세요.

마우스와 휴대폰에서의 Shift

마우스와 포인터 이벤트에도 shiftKey가 있어서 Shift + 클릭(범위 선택)에는 키 리스너가 필요 없어요. 휴대폰 화면 키보드에서 Shift 키 이벤트를 기대하지 마세요. 안드로이드는 키를 keyCode 229로 알리는 경우가 많고, 대문자는 그냥 텍스트로 도착해요.