Enter 키 코드
기본 Enter 키와 숫자패드의 Enter 키는 모두 event.key "Enter"와 keyCode 13을 보내요. event.code나 event.location으로 두 키를 구분할 수 있어요.
모든 값 한눈에 보기
| 키 | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Enter / Return | Enter | Enter | 13 | 0(일반) |
| 숫자패드 Enter | NumpadEnter | Enter | 13 | 3(숫자패드) |
keyCode는 Windows의 Chrome과 Edge가 보내는 값이에요. Mac 열(Mac의 Chrome과 Safari)과 Firefox 열에는 값이 다를 때만 표시돼요. 일부 키는 운영체제에 따라서도 값이 달라요. 아래 설명을 참고하세요. event.which는 항상 keyCode와 같은 값이에요. event.key는 Shift 없는 미국 배열 기준이에요.
여기서 눌러 보기
여기를 클릭한 뒤 Enter 키를 누르세요
키보드만 쓰나요? Esc를 누른 뒤 Tab을 눌러 키 상자에서 나오세요.
Enter 키에 반응하는 코드
document.addEventListener('keydown', (event) => {
if (event.key === 'Enter') {
// 여기에 내 코드
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Enter') {
// 여기에 내 코드
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 13) {
// 여기에 내 코드
}
});어떤 값을 쓸까요
event.key === 'Enter'를 확인하세요. 자판 배열과 상관없이 주 Enter 키와 숫자패드의 Enter 모두 같고, 실제 Enter를 보내는 휴대폰 키보드에서도 같아요.
두 키가 다르게 동작해야 할 때만 event.code를 쓰세요. Enter는 큰 키이고, NumpadEnter는 숫자패드의 키예요. Mac의 return 키도 같은 키라서 Enter를 보내요.
keyCode 13은 모든 브라우저에서 여전히 오기 때문에 예전 코드도 동작하지만, 더 이상 권장하지 않는 값이에요.
자주 막히는 부분
한국어·중국어·일본어를 입력하는 중인데 Enter로 메시지가 전송돼요
입력기를 쓰면 Enter는 먼저 만들던 글자를 확정해요. keydown 처리 코드에서도 이 Enter가 보여요. 글자를 조합하는 동안에는 건너뛰세요.
if (event.isComposing || event.keyCode === 229) return;
두 값을 모두 확인하세요. Safari는 확정하는 Enter를 isComposing false, keyCode 229로 보내요. 이렇게 하면 한글 조합을 확정하려고 누른 Enter로 메시지까지 전송되는 일을 막을 수 있어요.
입력란에서 Enter를 누르면 양식이 제출돼요
브라우저의 암묵적 제출 동작이에요. Enter가 다른 일을 해야 한다면 keydown 처리 코드에서 event.preventDefault()를 호출하세요. 키 대신 양식의 submit 이벤트를 들어도 돼요. 그러면 휴대폰 키보드의 이동 버튼도 함께 처리돼요.
처리 코드가 두 번 또는 여러 번 실행돼요
Enter를 누르고 있으면 keydown이 반복돼요. 메시지 보내기처럼 Enter로 한 번만 일어나야 하는 동작이라면 if (event.repeat) return;으로 반복을 무시하세요.
keypress나 keyup은 keydown과 다르게 동작해요
keypress는 더 이상 권장하지 않고, 무언가를 입력하는 키에서만 발생해요. Enter에서는 아직 발생하지만 이 이벤트에 기대지 마세요. keyup은 브라우저가 이미 양식을 제출하거나 줄을 바꾼 뒤에 와서 막기에는 늦어요. keydown을 쓰세요.
휴대폰에서 Enter가 “이동”, “다음”, “보내기”로 보여요
이름은 직접 정할 수 있어요. 입력란에 enterkeyhint="send"(또는 go, next, search, done)를 추가하세요. 안드로이드 키보드는 대부분의 키를 keyCode 229로 보내지만, Enter는 보통 keyCode 13인 실제 Enter로 와요.
Shift+Enter와 Ctrl+Enter
채팅창은 보통 Enter로 보내고 Shift + Enter로 줄을 바꿔요. event.shiftKey를 확인하세요. Ctrl + Enter(Mac에서는 Cmd + Enter)는 흔히 쓰는 “그래도 보내기” 단축키예요. event.ctrlKey || event.metaKey를 확인하세요. <textarea>에서는 preventDefault()를 호출하지 않으면 Enter로 줄이 바뀌어요.