Tab 키 코드

Tab은 Shift를 누르든 아니든 event.key로 "Tab", event.code로 "Tab", keyCode로 9를 보내요.

모든 값 한눈에 보기

Tab의 값
키event.codeevent.keykeyCodeevent.location
TabTabTab90(일반)

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

여기서 눌러 보기

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

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

Tab 키에 반응하는 코드

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

어떤 값을 쓸까요

event.key === 'Tab'을 확인하세요. Tab 키는 하나뿐이고 어떤 배열에서도 같은 값을 보내요. event.code도 "Tab"이에요.

Shift + Tab도 "Tab"을 보내요. Shift는 키의 이름을 바꾸지 않아요. 둘을 구분하려면 event.shiftKey를 확인하세요.

keyCode 9는 모든 브라우저에서 아직 전달되지만 더 이상 권장하지 않는 값이에요.

자주 막히는 부분

keyup이 다른 요소에 도착해요

Tab은 keydown에서 포커스를 옮겨요. 그래서 keydown은 떠난 입력란으로, keyup은 도착한 입력란으로 가요. 입력란의 keyup 핸들러는 누군가 Tab으로 그 칸에 들어올 때마다 Tab을 보게 돼요. Tab은 keydown에서 처리하세요.

키보드 사용자가 내 위젯에 갇혀요

Tab에서 preventDefault()를 호출하면 포커스가 움직이지 않아서 키보드 사용자는 빠져나올 수 없어요. 다른 탈출 방법이 없으면 WCAG 2.1.2 “키보드 함정 없음”을 지키지 못해요. 열려 있는 동안 포커스를 안에 가두는 모달 대화상자처럼 타당한 이유가 있을 때만 Tab을 막으세요. 그리고 Esc나 닫기 버튼 같은 분명한 탈출 방법을 주세요.

텍스트 영역에서 Tab이 들여쓰기 대신 입력란을 벗어나요

기본 동작이고 대부분의 사용자가 원하는 방식이에요. 코드 편집기라면 대신 탭 문자를 넣을 수 있어요.

if (event.key === 'Tab' && !event.shiftKey) {
  event.preventDefault();
  textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}

이 사이트의 키코드 확인 도구처럼 키보드만으로도 빠져나올 방법을 마련하세요. 먼저 Esc를 누르면 그다음 Tab이 다음 요소로 넘어가요. setRangeText()는 실행 취소 기록에 남지 않아요. document.execCommand('insertText', false, '\t')로 넣은 탭은 남지만, 이 메서드는 더 이상 권장하지 않아요.

Ctrl+Tab과 Alt+Tab은 페이지에 오지 않아요

브라우저와 컴퓨터가 가져가요. Ctrl + Tab은 브라우저 탭을 바꾸고, Alt + Tab(Mac에서는 Cmd + Tab)은 앱을 바꿔요. 페이지는 Ctrl이나 Alt의 keydown까지는 볼 수 있어도 그다음은 없어요. 사용자가 돌아오면 keyup이 다른 창으로 갔기 때문에 조합 키가 눌린 채로 보일 수 있어요. 창의 blur 이벤트에서 조합 키 상태를 초기화하세요.

Safari에서는 Tab이 링크와 버튼을 건너뛰어요

기본적으로 Mac의 Safari는 입력란 사이만 옮겨 다녀요. Option + Tab을 누르면 링크와 버튼까지 이동할 수 있어요. Tab만으로 이동하려면 Safari의 설정 > 고급에서 “Tab을 눌러 웹 페이지에 있는 각 항목을 하이라이트”를 켜세요. 그 설정을 켜고 탭 순서를 테스트하세요. Mac 사용자가 Tab만으로 버튼에 간다고 생각하지 마세요.

탭 순서

Tab은 HTML에 있는 요소의 순서를 따라요. tabindex="0"은 그 순서에 요소를 넣고 tabindex="-1"은 빼요. 양수는 피하세요. 다른 모든 것보다 앞서 가서 사람들을 헷갈리게 해요.