Escape 키 코드
Esc는 event.key "Escape", event.code "Escape", keyCode 27을 보내요.
모든 값 한눈에 보기
| 키 | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Esc | Escape | Escape | 27 | 0(일반) |
keyCode는 Windows의 Chrome과 Edge가 보내는 값이에요. Mac 열(Mac의 Chrome과 Safari)과 Firefox 열에는 값이 다를 때만 표시돼요. 일부 키는 운영체제에 따라서도 값이 달라요. 아래 설명을 참고하세요. event.which는 항상 keyCode와 같은 값이에요. event.key는 Shift 없는 미국 배열 기준이에요.
여기서 눌러 보기
여기를 클릭한 뒤 Escape 키를 누르세요
키보드만 쓰나요? Esc를 누른 뒤 Tab을 눌러 키 상자에서 나오세요.
Escape 키에 반응하는 코드
document.addEventListener('keydown', (event) => {
if (event.key === 'Escape') {
// 여기에 내 코드
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Escape') {
// 여기에 내 코드
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 27) {
// 여기에 내 코드
}
});어떤 값을 쓸까요
event.key === 'Escape'를 확인하세요. Esc 키는 하나뿐이고 자판 배열과 상관없이 같은 값을 보내요. 그래서 event.key와 event.code가 같은 값을 알려 줘요. key가 읽기 더 편해요.
keyCode 27은 모든 브라우저에서 여전히 오지만 더 이상 권장하지 않는 값이에요.
아주 오래된 브라우저(Internet Explorer와 Firefox 36 이하)는 "Esc"를 보냈어요. 그런 브라우저를 아직 지원할 때만 둘 다 받으세요.
자주 막히는 부분
Esc로 전체 화면이 풀리는데 처리 코드로 막을 수 없어요
전체 화면 모드나 포인터 잠금 상태에서는 브라우저가 Esc를 처리해요. Esc를 누르면 전체 화면 모드가 끝나거나 포인터 잠금이 풀리고, preventDefault()로는 막을 수 없어요. 처리 코드에 그 Esc가 오지 않을 수도 있어요. 언제 끝났는지는 fullscreenchange를 들어서 알 수 있어요. Chromium에서는 게임이 전체 화면일 때 navigator.keyboard.lock(['Escape'])를 호출할 수 있어요. 이 경우 사용자는 Esc를 길게 눌러 나가요.
취소했는데도 대화상자가 닫혀요
모달 <dialog>는 Esc에 저절로 닫혀요. 먼저 cancel 이벤트를 보내는데, 이것은 막을 수 있어요.
dialog.addEventListener('cancel', (event) => event.preventDefault());
Chrome에서는 한 번만 막을 수 있어요. 그 사이에 아무것도 클릭하지 않고 Esc를 다시 누르면 그대로 닫혀요. 일부러 대화상자를 열어 두려면 지원하는 브라우저에서 closedby="none"을 지정하고, 사용자의 작업은 cancel에 기대지 말고 close 이벤트에서 저장하세요.
Esc 한 번에 두 가지가 닫혀요
대화상자 안에서 메뉴가 열려 있으면 둘 다 같은 Esc를 들어요. 가장 안쪽 요소만 닫으세요. 메뉴에서 Esc를 처리하고 event.stopPropagation()을 호출해 대화상자 코드가 실행되지 않게 하세요. 브라우저가 HTML <dialog> 요소까지 닫지 않도록 event.preventDefault()도 호출하세요. 닫히는 것은 처리 코드가 아니라 브라우저의 기본 동작이에요.
검색란에서 Esc를 누르면 내용이 지워져요
Chrome 등 일부 브라우저에서는 Esc가 <input type="search">를 비워요. Esc로 검색창을 닫으려면 keydown에서 preventDefault()를 호출하거나, 지우기와 닫기를 한 번에 처리하세요.
아이패드 키보드에는 Esc 키가 없어요
Esc 키가 없는 아이패드 키보드도 있고, 휴대폰에는 아예 없어요. 눈에 보이는 닫기 버튼을 항상 함께 두세요. Esc는 단축키일 뿐, 유일한 출구가 아니에요.
출구로서의 Esc
키보드 사용자는 Esc가 메뉴, 팝업, 대화상자를 닫고, 처음에 그것을 열었던 버튼으로 포커스가 돌아가기를 기대해요. 코드 편집기나 키코드 확인 도구의 입력 상자처럼 모든 키 입력을 처리하는 위젯이라면 Esc를 누른 뒤 Tab으로 빠져나갈 수 있게 하세요. 키보드 사용자가 갇히는 일을 막아요.