Если вкладка подсветилась, а текст под ней остался прежним, сравните три вещи: куда перешёл фокус, какая кнопка считается выбранной и какая панель видима. Это разные состояния. Начните на тестовой копии с двух вкладок без загрузки данных: так проще отделить ошибку переключения от медленного запроса.
Откройте инструменты разработчика, выберите кнопку и найдите панель по её aria-controls. ID должен вести ровно к одному элементу в документе. Копирование готового блока с теми же ID часто связывает второй набор кнопок с первым набором панелей. Внешне ошибка похожа на неработающий JavaScript, хотя обработчик успешно меняет чужой элемент.
Подсветка ещё не доказывает переключение
| Наблюдение | Что сравнить |
|---|---|
| Рамка фокуса переместилась | aria-selected и видимость панели |
| Выбрана новая кнопка, текст прежний | aria-controls и реальный ID панели |
| Две панели видны сразу | hidden и перекрывающий его CSS |
| Второй блок меняет первый | уникальность ID и область поиска элементов |
В ручном режиме стрелки могут переносить фокус без активации: панель открывается по Enter или пробелу. В автоматическом режиме фокус выбирает вкладку сразу. APG описывает оба режима; автоматический вариант рекомендован, когда панель появляется без заметной задержки. Сначала установите задуманный режим, иначе корректное поведение легко принять за поломку.
Одна функция обновляет весь выбранный набор
// Условный фрагмент смены состояния внутри одного компонента.
// Не заменяет обработку стрелок и инициализацию клавиатуры.
function selectTab(root, target) {
const tabs = [...root.querySelectorAll('[role=tab]')];
const panels = [...root.querySelectorAll('[role=tabpanel]')];
const id = target.getAttribute('aria-controls');
if (!tabs.includes(target) || !panels.some(p => p.id === id)) return;
tabs.forEach(tab => {
const selected = tab === target;
tab.setAttribute('aria-selected', String(selected));
tab.tabIndex = selected ? 0 : -1;
});
panels.forEach(panel => { panel.hidden = panel.id !== id; });
}Этот пример рассчитан на плоский блок без вложенных табов и с заранее уникальными ID. Он показывает общую точку обновления, а не готовый виджет. Перед изменением состояния функция убеждается, что нужная панель существует. Для вложенных компонентов ограничьте выборку собственными элементами: даже поиск внутри root может захватить дочерний набор.
Не храните независимо active-класс, числовой индекс и ID выбранной вкладки, если каждый обработчик меняет только часть этой тройки. В проекте на React или другом фреймворке используйте его состояние для вывода атрибутов и панелей, не вмешиваясь параллельно прямыми DOM-изменениями. Выберите одного владельца состояния.
Что происходит, когда панель загружается позже
Условный сценарий: читатель выбирает «Описание», затем «Отзывы», а ответ первого запроса приходит последним. Если ответ просто заменяет общий контейнер, содержимое снова станет чужим. Привяжите результат к ID панели и версии запроса. Поздний ответ допустимо сохранить в кеш нужной панели, но он не должен самовольно менять текущий выбор.
- Переключить первую и последнюю вкладки мышью.
- Пройти набор стрелками, затем активировать Enter и пробелом в выбранном режиме.
- Нажать Tab и убедиться, что фокус выходит из списка предсказуемо.
- Повторить действия во втором экземпляре блока.
- Задержать тестовый ответ и быстро изменить выбор.
Если содержимое панели не начинается с доступного фокусу элемента, APG предусматривает включение самой панели в последовательность Tab через tabindex="0". Фокус должен быть видимым. Не удаляйте outline ради чистого дизайна: без него клавиатурный тест перестаёт показывать положение пользователя.
Минимальный материал для воспроизведения
Сохраните HTML обоих наборов, функцию выбора, правила CSS для hidden и точную последовательность действий. Укажите, нужен ручной или автоматический режим. После исправления сравните выбранную кнопку и видимую панель при каждом шаге, а не только цвет вкладки.
Выпускайте изменение вместе с прежней версией компонента для отката. Если проблема появляется только при повторном открытии страницы в приложении, проверьте повторную инициализацию и снятие старых слушателей. Для разбора полезнее маленький пример с двумя конфликтующими ID, чем архив всего сайта: он показывает связь, которая действительно ломается.