IHOR.DEVБАЗА_ЗНАНЬ
МЕНЮ

~/blog / Якість / keyboard-navigation-for-web-applications.md

// посібник · 2 хв читання

Клавіатурна навігація для вебзастосунків

Проєктуйте keyboard-access нативними controls, логічним focus-order, widget-keys, modal-focus і відновленням після dynamic-змін.

Коротка відповідь

Почніть із нативних buttons, links і controls. Узгодьте Tab із читанням і задачею, покажіть focus, застосовуйте arrow-keys до відповідних widgets. Без pointer мають працювати відкриття, використання й закриття overlays.

Focus і selection різні. Tab може мати focus до selection; listbox має власні правила. Не перехоплюйте глобально arrows, Space чи Escape. Поважайте editable й pattern widget.

Практичні кроки реалізації

Збережіть логічний порядок

DOM визначає sequence; positive tabindex створює штучний порядок. 0 додає до Tab, -1 — programmatic-focus. Це не додає button-семантики, активації чи disabled. Обирайте native.

Визначте widget-keys

Для tabs, menus, grids і listboxes реалізуйте весь pattern, не лише role. Composite має один Tab-вхід і внутрішні keys. Auto/manual tabs залежать від latency; selected-state точний. Звичайна navigation не потребує application-menu автоматично.

Керуйте overlays і restore

Modal потребує name, початковий focus, containment, close й return. За зниклого invoker оберіть логічне. Async-delete і list-update також прибирають focused; визначте наступне, не body випадково.

Перевірте focus і shortcuts

Focus видимий на фактичному фоні без sticky-перекриття. Перевірте вперед/назад, narrow й zoom. Опис Native Color Picker має shortcut і Enter/Space для picking, не повний audit. Shortcuts доповнюють controls і можуть конфліктувати.

Приклад реалізації

React використовує native-button і стан disclosure. Вміст лишається в DOM-order. Disclosure не modal, тому без focus-trap.

import { useId, useState } from "react";

export function HelpDisclosure() {
  const id = useId();
  const [open, setOpen] = useState(false);
  return (
    <section>
      <button type="button" aria-expanded={open} aria-controls={id}
        onClick={() => setOpen(value => !value)}>Keyboard help</button>
      <div id={id} hidden={!open}>
        <p>Use Tab to reach controls and Shift+Tab to move back.</p>
      </div>
    </section>
  );
}

Розмістіть у client-межі фреймворку. Enter/Space дає button. Другий keydown може подвійно перемкнути й скасувати. Перевірте keys і state.

Компроміси та альтернативи

Native зменшує реалізацію. Composite корисний великим даним, але додає keys, focus і semantics. Виберіть перевірений компонент за pattern, перевіряючи integration, не всю доступність за бібліотекою.

Поширені помилки

  • Clickable div замість actions.
  • Positive tabindex для хибного DOM.
  • Trap у disclosure.
  • Focus на deleted.
  • Global-handler заважає editing.

Контрольний список перед випуском

  • Native для actions.
  • Forward/reverse відповідають задачі.
  • Keys і states правильні.
  • Dialog і restore працюють.
  • Видалення має target.
  • Focus видимий narrow/zoom.

Поширені запитання

Чи все має бути focusable?

Ні. Controls мають focus-model; статичний текст — reading-order без Tab. Зайве сповільнює й плутає.

Чи вистачає role=button?

Ні. Native-поведінки немає. Використовуйте button, якщо немає справжньої потреби повної альтернативи.

Висновок

Native спершу, custom-pattern документуйте й перевіряйте повний focus-шлях. Keyboard-support — контракт задачі, не додаткові tabindex.

Первинні джерела

Пов’язані посібники та приклади

Ігор Харчишин

Незалежний full-stack інженер продуктів, який пише посібники з реалізації розширень браузера та сучасних вебпродуктів на основі першоджерел.

Потрібно реалізувати це у вашому продукті?

Пов’язана реалізація інтерфейсу, логіки застосунку, API та шару даних.