Раздел аккордеона может не открываться из-за двух независимых переключателей. Браузер меняет состояние details по нажатию summary, а ваш обработчик меняет его ещё раз. На тестовой копии временно отключите именно дополнительный переключатель и посмотрите, остаётся ли атрибут open после нажатия.
Если open остаётся, а ответ не виден, переходите к CSS: display, скрытая высота и overflow могут прятать уже открытое содержимое. Если open появляется и исчезает, ищите второй обработчик или повторную инициализацию. Эти наблюдения дают разные направления поиска; увеличение z-index в обоих случаях обычно ничего не объясняет.
Для простого раскрытия хватает встроенного элемента
<!-- Условный самостоятельный FAQ без JavaScript -->
<details class="faq-item">
<summary>Можно ли изменить адрес доставки?</summary>
<p>До передачи заказа в доставку адрес меняет оператор.</p>
</details>У details состояние открытия задаётся наличием логического атрибута open. Запись open="false" всё равно означает открытый элемент; для закрытия атрибут убирают или присваивают свойству open значение false. Не добавляйте свой ручной toggle только ради изменения стрелки: внешний вид можно связать с существующим состоянием.
Сначала проверьте этот короткий блок без темы оформления и плагина. Затем возвращайте стили по одному. Если нативное раскрытие работает, сравнение сузит проблему до конкретной надстройки. Не меняйте сразу разметку, анимацию и библиотеку: после такого набора правок трудно понять, что помогло и что сломало другие разделы.
Две дорожки поиска: состояние или геометрия
| Состояние после нажатия | Следующий шаг |
|---|---|
| open отсутствует | проверить preventDefault и обработчики summary |
| open кратко появляется | посчитать смены состояния и повторные слушатели |
| open есть, панель пустая | посмотреть display и высоту содержимого |
| После подгрузки ответ обрезан | убрать фиксированную высоту и сравнить результат |
Поставьте точку останова на обработчик клика в инструментах разработчика. Одно нажатие не должно запускать две независимые функции, каждая из которых инвертирует состояние. Это бывает после повторного монтажа компонента, подключения двух версий скрипта или делегирования события одновременно на контейнере и самой кнопке.
Логирование события toggle помогает увидеть итоговое состояние, но число таких событий не всегда равно числу быстрых присваиваний: браузер может объединять их. Для выяснения источника лишнего изменения проследите сами обработчики. Не делайте вывод о единственном переключателе только потому, что в консоли видна одна строка.
Анимация должна переживать изменение ответа
Условный пример: при открытии скрипт измерил короткий текст и записал height в пикселях. Затем загрузилось изображение или появился перевод длиннее исходного. Панель по-прежнему открыта, но нижняя часть обрезана. Для диагностики отключите переход и ограничения высоты; если весь ответ появился, причина находится в расчёте геометрии.
Выберите стратегию под реальное содержимое. Простой FAQ может обходиться без анимации высоты. Для динамического ответа пересчёт должен учитывать загрузку и изменение размеров, а после завершения раскрытия содержимое не должно оставаться зажатым устаревшим значением. Не копируйте большое max-height вслепую: оно маскирует ограничение, не создавая ясного договора.
Собственный аккордеон проверяют отдельно от details
Если вместо нативного элемента используется кнопка и отдельная панель, библиотека отвечает за взаимодействие. APG описывает кнопку в заголовке, aria-expanded согласно видимости и aria-controls со ссылкой на панель. Для раскрытия предусмотрены Enter и пробел. Это другой вариант реализации; добавление ARIA к случайному div само по себе не подключает поведение.
- Открыть и закрыть один раздел с клавиатуры.
- Развернуть два ответа, если дизайн это разрешает.
- Повторить открытие после перехода внутри приложения.
- Добавить длинный ответ и изображение с поздней загрузкой.
- Убедиться, что закрытая панель не оставляет доступные фокусу скрытые поля.
Проверьте, не отправляет ли кнопка раскрытия окружающую форму: в таком случае ей нужен type="button". Исправление выкладывайте отдельно от переработки дизайна, чтобы откат был небольшим и понятным. Для диагностики подготовьте один HTML-раздел, список подключённых скриптов и запись изменения open либо aria-expanded. По ним видно, ломается ли переключение или только показ текста.