Коротка відповідь
Почніть із нативних 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.
Первинні джерела
Пов’язані посібники та приклади
Потрібно реалізувати це у вашому продукті?
Пов’язана реалізація інтерфейсу, логіки застосунку, API та шару даних.