문자 단축키

무엇을 요구하나요?

글자·숫자·기호 키 하나만으로 실행되는 단축키가 있다면 다음 중 하나를 만족해야 합니다.

• 사용자가 단축키를 끌 수 있다
• 다른 키(Ctrl, Alt 등 조합)로 바꿀 수 있다
• 해당 요소에 초점이 있을 때만 동작한다

화면 낭독기 사용자는 글자 키로 화면을 탐색하고(예: H로 제목 이동), 음성 입력 사용자는 말한 단어가 글자 키로 입력됩니다. 이때 한 글자 단축키가 의도치 않게 실행될 수 있습니다.

자주 틀리는 예

1. 페이지 어디서나 ’/’ 키로 검색창 이동, ‘s’로 저장

document.addEventListener('keydown', (e) => {
  if (e.key === 's') save();
  if (e.key === '/') searchInput.focus();
});

const settings = { singleKeyShortcuts: false }; // 기본은 끔, 설정 화면에서 켤 수 있게
document.addEventListener('keydown', (e) => {
  if (!settings.singleKeyShortcuts) return;
  if (e.target.closest('input, textarea, [contenteditable]')) return; // 입력 중에는 무시
  if (e.key === 's') save();
});

2. 조합키로 바꾸기

document.addEventListener('keydown', (e) => {
  if (e.altKey && e.key.toLowerCase() === 's') { e.preventDefault(); save(); }
});

단축키가 있다면 도움말에 목록을 알려주세요.

확인하는 방법

1. 페이지에서 입력 칸이 아닌 곳을 누른 뒤 글자 키(a~z, 숫자, /, ?)를 하나씩 눌러 무언가 실행되는지 확인하세요.
2. 단축키가 있다면 끄거나 바꾸는 설정이 있는지, 특정 요소에 초점이 있을 때만 동작하는지 확인하세요.
3. 개발자에게 keydown·keypress 이벤트로 처리하는 단축키 목록을 받아 확인하는 것이 가장 정확합니다.