Гайды

Как добавить горячие клавиши на сайт — и не сломать печать в полях

Иллюстрация: гигантская клавиатура — две клавиши нажаты и светятся

Есть баг, который в хоткеях пишут все с первого раза. Пользователь печатает комментарий, нажимает букву «d» — и твой сайт удаляет задачу. Потому что слушатель клавиш не знает, что человек сейчас в поле ввода. Разберём хоткеи по шагам — с этим багом, русской раскладкой и клавишами, которые перехватить нельзя.

Шаг 1. Один слушатель keydown

Не вешай обработчики на каждую кнопку. Один слушатель на всё окно:

window.addEventListener('keydown', (e) => {
  console.log(e.key, e.code);
});

Открой консоль и понажимай клавиши. e.key — символ («k», «Enter»), e.code — физическая клавиша («KeyK»). Разница выстрелит на шаге 4.

Шаг 2. Реагируй на комбинацию, а не на букву

Хороший шорткат — с модификатором: Cmd+K, Ctrl+S. На Mac главная клавиша — Cmd (metaKey), на Windows — Ctrl (ctrlKey). Поддержи обе одной строкой:

window.addEventListener('keydown', (e) => {
  const mod = e.metaKey || e.ctrlKey;
  if (mod && e.code === 'KeyK') {
    e.preventDefault();
    openSearch();
  }
});

e.preventDefault() обязателен: иначе браузер выполнит и своё действие тоже (Ctrl+S откроет сохранение страницы).

Важный предел: Cmd+W, Ctrl+T и другие клавиши вкладок браузер не отдаст — обработчик даже не вызовется. Не строй шорткаты на них.

Шаг 3. Главный баг — защити поля ввода

Теперь тот самый баг. «Голые» шорткаты без модификатора — «d» удалить, «?» помощь — обязаны молчать, пока человек печатает:

function isTyping(e) {
  const el = e.target;
  return el.matches('input, textarea, select') || el.isContentEditable;
}

window.addEventListener('keydown', (e) => {
  if (isTyping(e)) return;
  if (e.key === '?') showHotkeyHelp();
});

e.target — элемент, где случилось нажатие. Если это поле ввода — выходим. Комбинациям с Cmd/Ctrl такая защита не нужна: при печати они не возникают случайно.

Шаг 4. Переживи русскую раскладку

Коварная деталь, о которой молчат англоязычные гайды. В русской раскладке e.key для клавиши K вернёт «л» — и шорткат e.key === 'k' молча умрёт.

Лечение простое: для буквенных шорткатов сравнивай e.code. «KeyK» — это физическая клавиша, ей всё равно, какой язык включён. Для символьных («?», «/») наоборот оставляй e.key — тебе важен именно символ.

Шаг 5. Подскажи, что шорткаты существуют

Горячие клавиши, о которых никто не знает, не существуют. Стандарт индустрии — клавиша «?» открывает список шорткатов: так делают GitHub и Gmail. Добавь маленький оверлей со списком — это две строки разметки, а фича начинает жить.

Шаг 6. Начни с правильного набора

Не выдумывай экзотику — бери шорткаты, к которым руки уже привыкли в других приложениях:

  1. Cmd/Ctrl+K — поиск или палитра команд. Стал общим стандартом: Slack, Notion, GitHub.
  2. Esc — закрыть модалку или отменить. Пользователи жмут его инстинктивно; если модалка не закрывается по Esc, приложение ощущается сломанным.
  3. «?» — показать список шорткатов.
  4. Enter в списке — открыть выбранный элемент.
  5. j / k — вниз-вверх по списку, как в Gmail и GitHub. Это «голые» буквы — им обязателен guard из шага 3 и e.code из шага 4.

Четырёх-пяти достаточно для старта. Экзотические цепочки добавишь, когда появятся власть привычки и запросы пользователей.

Что получится: Cmd+K открывает поиск, Esc закрывает окна, «?» показывает подсказку, печать в полях ничего не ломает — и всё работает на любой раскладке. Опытные пользователи заметят: по ощущению «приложение сделано аккуратно» хоткеи бьют сильнее многих больших фич. Хорошо заходит и тумблер тёмной темы на клавише «t».

Почему шорткат не работает у части пользователей?

Чаще всего — раскладка: ты сравнил e.key === 'k', а у пользователя включён русский. Сравнивай e.code === 'KeyK' — и шорткат переживёт любой язык.

Нужна ли библиотека для горячих клавиш?

Для двух-трёх шорткатов — нет: слушатель из этого гайда покрывает всё. Библиотеки становятся полезны на цепочках вроде «g, потом i» как в Gmail — но принцип внутри тот же keydown.

Работают ли горячие клавиши на телефоне?

Нет клавиатуры — нет хоткеев. На тач-устройствах прячь подсказку «нажми ?» — она только путает.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →