Caps Lock 키 코드

Caps Lock은 event.key "CapsLock", event.code "CapsLock", keyCode 20을 보내요.

모든 값 한눈에 보기

Caps Lock의 값
키event.codeevent.keykeyCodeevent.location
Caps LockCapsLockCapsLock200(일반)

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

여기서 눌러 보기

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

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

Caps Lock 키에 반응하는 코드

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

어떤 값을 쓸까요

Caps Lock이 켜져 있는지 알려면 키를 지켜보지 마세요. 키보드나 마우스 이벤트가 발생하면 그 이벤트에서 상태를 확인하세요. 켜져 있으면 event.getModifierState('CapsLock')가 true예요. 페이지를 열기 전에 Caps Lock을 켰더라도 잘 동작해요.

키 자체에 반응하려면 event.key === 'CapsLock'을 확인하세요. (event.code도 같아요.) keyCode는 20이지만 더 이상 권장하지 않는 값이에요.

Caps Lock은 글자의 event.key를 바꾸지만(“a” 대신 “A”) event.code나 keyCode는 바꾸지 않아요.

Windows의 한국어 입력기에서 Caps Lock은 영문 입력 상태일 때 대문자를 고정해요. 한글과 영문 입력은 한/영 키로 전환해요. macOS에서는 설정에 따라 Caps Lock 키가 한/영 전환에 쓰이기도 해요.

자주 막히는 부분

“Caps Lock이 켜져 있어요” 안내가 틀려요

Caps Lock을 누른 횟수를 세면 페이지를 열기 전부터 켜져 있었을 때 바로 틀려요. 대신 비밀번호 입력란의 이벤트마다 상태를 읽으세요.

function checkCaps(event) {
  warning.hidden = !event.getModifierState('CapsLock');
}
password.addEventListener('keydown', checkCaps);
password.addEventListener('keyup', checkCaps);

blur 이벤트에서는 안내를 숨기세요. 상태는 사용자가 키를 누르거나 마우스를 움직여야 알 수 있어요. 페이지를 열 때 물어볼 방법은 없어요.

Mac에서는 Caps Lock이 이벤트를 하나만 보내요

Windows와 Linux에서 Caps Lock은 다른 키처럼 keydown과 keyup을 보내요. Mac의 Chrome과 Safari는 켜질 때 keydown만, 꺼질 때 keyup만 보내요. Mac의 Firefox는 누를 때마다 keydown만 보내요. 그래서 위의 안내 코드는 둘 다 듣도록 했어요.

Caps Lock 자체의 이벤트에서는 상태가 예전 값이에요

Caps Lock 이벤트가 일어나는 동안 getModifierState가 이미 새 상태를 보여 주는지는 브라우저마다 달라요. 다음 키나 keyup에서 다시 확인하세요.

짧게 톡 치면 켜지지 않아요 (Mac)

macOS는 Caps Lock을 아주 짧게 치면 무시해요. 살짝 스친 키로는 켜지지 않아요. 페이지에는 이벤트가 오는데 표시등은 꺼져 있을 수 있어요. 이벤트 횟수가 아니라 getModifierState를 믿으세요.

휴대폰은 Caps Lock이 켜졌다고 알려 주지 않아요

화면 키보드에는 자체 Caps Lock이 있어요(Shift 두 번 탭). 이것은 Caps Lock 이벤트를 보내지 않고, getModifierState('CapsLock')도 계속 false예요. 외장 키보드만 상태를 알려 줘요.

게임과 단축키에서의 Caps Lock

Caps Lock을 누르고 있는 키로 쓰지 마세요. Mac에서는 누르는 동안 keyup이 오지 않아요. Ctrl이나 Esc로 바꿔 쓰는 사람도 있는데, 그러면 페이지는 바꾼 키를 받아요. Mac의 Safari는 비밀번호 입력란에 이미 Caps Lock 표시를 보여 주므로 안내가 두 번 나타날 수 있어요.