Если вкладка подсветилась, а текст под ней остался прежним, сравните три вещи: куда перешёл фокус, какая кнопка считается выбранной и какая панель видима. Это разные состояния. Начните на тестовой копии с двух вкладок без загрузки данных: так проще отделить ошибку переключения от медленного запроса.

Откройте инструменты разработчика, выберите кнопку и найдите панель по её 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 панели и версии запроса. Поздний ответ допустимо сохранить в кеш нужной панели, но он не должен самовольно менять текущий выбор.

  1. Переключить первую и последнюю вкладки мышью.
  2. Пройти набор стрелками, затем активировать Enter и пробелом в выбранном режиме.
  3. Нажать Tab и убедиться, что фокус выходит из списка предсказуемо.
  4. Повторить действия во втором экземпляре блока.
  5. Задержать тестовый ответ и быстро изменить выбор.

Если содержимое панели не начинается с доступного фокусу элемента, APG предусматривает включение самой панели в последовательность Tab через tabindex="0". Фокус должен быть видимым. Не удаляйте outline ради чистого дизайна: без него клавиатурный тест перестаёт показывать положение пользователя.

Минимальный материал для воспроизведения

Сохраните HTML обоих наборов, функцию выбора, правила CSS для hidden и точную последовательность действий. Укажите, нужен ручной или автоматический режим. После исправления сравните выбранную кнопку и видимую панель при каждом шаге, а не только цвет вкладки.

Выпускайте изменение вместе с прежней версией компонента для отката. Если проблема появляется только при повторном открытии страницы в приложении, проверьте повторную инициализацию и снятие старых слушателей. Для разбора полезнее маленький пример с двумя конфликтующими ID, чем архив всего сайта: он показывает связь, которая действительно ломается.

Проверенные источники