Тег details в HTML: как сделать раскрывающийся блок

Тег details (от английского details, «подробности») создаёт блок, который раскрывается и сворачивается по клику без JavaScript. Первым потомком записывают заголовок summary, а состояние хранит булев атрибут open. Закрывающий </details> обязателен. Остальное содержимое видно только в раскрытом блоке.

Если нужен только готовый рабочий блок, хватит урока «Раскрывающийся блок: details и summary». В статье разобраны атрибуты open и name, раскрытие блока при поиске и по ссылке-якорю, стили и анимация через ::details-content, события и свойства в JavaScript, доступность и причины, по которым блок не работает. Заголовок блока и его маркер собраны на странице про тег summary, а другие теги группы в справочник по тегам.

HTML
<details>
  <summary>Как оформить возврат</summary>
  <p>Заявку подают в течение 14 дней после покупки.</p>
</details>

Тег details в HTML: что это и для чего нужен

Раскрывающийся блок собирается из двух тегов, а его состояние хранит один булев атрибут.

Тег details парный: закрывающий </details> обязателен. Если его пропустить, всё, что записано после блока, окажется внутри него. Первым потомком записывают summary: его текст виден всегда и работает как заголовок. Остальное содержимое выводится только в раскрытом состоянии, а в закрытом браузер его не отображает.

Состояние блока записано в атрибуте open. Пока его нет, блок закрыт. Клик по заголовку, клавиши Enter и Space переключают блок, и браузер сам добавляет или убирает open в разметке. У самого details нет ни стрелки, ни текста: маркер и надпись выводит summary.

HTML
<details open>
  <summary>Как оформить возврат</summary>
  <p>Заявку подают в течение 14 дней после покупки.</p>
</details>

Пример: открытое и закрытое состояние блока

Результат

Клик по заголовку меняет строку с тегом: браузер сам добавляет open и убирает его. Кнопки делают то же самое из скрипта.

ЭлементЧто делает
detailsКонтейнер: хранит состояние в open и объединяет блоки в группу через name
summaryЗаголовок блока: виден всегда, по клику переключает состояние
Остальное содержимоеАбзацы, списки, ссылки и любые другие теги: видно только в раскрытом блоке

Атрибуты тега details: open, name и глобальные

У details два собственных атрибута, остальные общие для любого тега.

АтрибутЧто делаетПример записи
openБлок раскрыт. Булев: важно только наличие атрибутаopen
nameОбъединяет блоки в группу, где открыт не больше одного. Значения сравниваются с учётом регистраname="faq"
idЯкорь для ссылки. Ссылка на сам блок его не раскрывает, а ссылка на элемент внутри раскрываетid="deadline"
class, styleПодключают оформление блокаstyle="margin-top: 8px"
titleПодсказка при наведении на весь блокtitle="Подробности"
ontoggleОбработчик события toggle, которое приходит при каждой смене состоянияontoggle="log(this.open)"

Атрибут name тега details: группа с одним открытым блоком

Базовая запись группы и пример аккордеона есть в уроке «Аккордеон без JS: атрибут name», а здесь разобрано, когда браузер закрывает соседей и где группа ведёт себя неочевидно.

HTML
<details name="faq" open>
  <summary>Сроки возврата</summary>
  <p>Четырнадцать дней.</p>
</details>
<details name="faq">
  <summary>Способы возврата</summary>
  <p>Курьером или в пункте выдачи.</p>
</details>

Соседей закрывает не только клик. Остальные блоки группы закрываются, когда один из блоков открывают из скрипта (open = true или атрибут open) или переходят по ссылке на элемент внутри него. При этом событие toggle сначала приходит у открытого блока, а затем у закрытого соседа.

Если скрипт открывает два блока группы подряд, остаётся открытым последний. Значения name сравниваются с учётом регистра: faq и FAQ образуют две разные группы. Убрать блок из группы можно, удалив у него name: он начинает открываться независимо от остальных.

Вложенный блок с тем же name, что и у внешнего, входит в ту же группу: его открытие закрывает внешний блок, и вложенный пропадает вместе с ним. Вложенным блокам задают другое значение. В более старых версиях браузеров атрибут не поддерживается, и блоки раскрываются независимо друг от друга.

Пример: две группы блоков и выход блока из группы

Результат

Откройте блок A2, затем A3: прежний блок группы закрывается. Блоки B1 и B2 образуют отдельную группу. Если убрать у A2 атрибут name, блок открывается независимо от A1 и A3.

Тег details и поиск по странице: Ctrl+F и ссылка-якорь

Содержимое закрытого блока не выводится, но поиск и переходы по ссылкам умеют его раскрывать.

HTML
<a href="#deadline">Когда заканчивается акция</a>

<details>
  <summary>Условия акции</summary>
  <p>Скидка действует <b id="deadline">до конца месяца</b>.</p>
</details>

Ссылка на элемент внутри закрытого блока раскрывает блок и прокручивает страницу к элементу. То же происходит при смене location.hash из скрипта и при переходе по ссылке с фрагментом текста #:~:text=. Поиск по странице (Ctrl+F) обычно тоже раскрывает блок, в котором найдено слово, но это зависит от браузера.

Ссылка на сам details его не раскрывает: страница прокручивается к блоку, а он остаётся закрытым. Метод scrollIntoView() тоже ничего не раскрывает, поэтому перед ним блок открывают вручную: el.closest('details').open = true. Когда блок раскрывается переходом, приходит событие toggle.

Тот же механизм работает у любого элемента с атрибутом hidden="until-found": при переходе к его содержимому браузер снимает hidden и показывает элемент, а перед этим элемент получает событие beforematch.

Пример: что раскрывает блок, а что нет

Результат

Закрытый блок раскрывается только при переходе к элементу внутри него. Переход к самому details и вызов scrollIntoView() оставляют блок закрытым. Блок со значением until-found показывается при переходе к его содержимому.

Стили тега details: рамка, отступы и ::details-content

По умолчанию details остаётся обычным блоком без рамки и отступов, поэтому оформление задают самостоятельно.

Вид контейнера задают обычными правилами для details, а раскрытое состояние оформляют отдельно селектором details[open]. Содержимое без заголовка выбирает псевдоэлемент ::details-content: ему можно задать фон, отступы и рамку, и summary они не затрагивают. Селектор появился в браузерах в 2024 и 2025 годах, а в более старых версиях правило не срабатывает, и блок выглядит как раньше.

CSS
details {
  border: 1px solid #c9bfb2;
  border-radius: 8px;
}
details[open] {
  border-color: #ff6b6b;
}
details::details-content {
  padding: 8px 12px;
  background: #fff1ea;
}

Свойство display у details лучше не менять. С display: flex заголовок и содержимое окажутся в одной строке, а для раскладки внутри блока содержимое оборачивают в div.

Пример: оформление блока и его содержимого

Результат

Отметьте правила по одному: код под блоком собирается из выбранного. Рамка и цвет задаются самому details, а отступ и фон только содержимому: заголовок остаётся на месте.

Анимация тега details: плавное раскрытие блока

Раскрытие блока по умолчанию мгновенное, а плавность добавляют стили для ::details-content.

Анимация собирается из трёх частей: начальное значение для закрытого блока, значение для details[open] и переход, где перечислено ещё и свойство content-visibility. Без него закрытие происходит мгновенно: содержимое прячется сразу, и анимировать нечего. С ключевым словом allow-discrete браузер дожидается конца перехода и только потом прячет содержимое.

Плавное изменение высоты до auto даёт свойство interpolate-size: allow-keywords. Оно пока поддерживается не везде: там, где его нет, высота меняется сразу. Прозрачность от interpolate-size не зависит, поэтому её оставляют запасным вариантом. Людям, которые отключили анимацию в системе, переход не показывают: его оборачивают в @media (prefers-reduced-motion: no-preference). Если нажать на заголовок посреди анимации, блок плавно возвращается назад.

CSS
@media (prefers-reduced-motion: no-preference) {
  details { interpolate-size: allow-keywords; }
  details::details-content {
    block-size: 0;
    overflow: clip;
    opacity: 0;
    transition: block-size .4s, opacity .4s,
      content-visibility .4s allow-discrete;
  }
  details[open]::details-content {
    block-size: auto;
    opacity: 1;
  }
}

Пример: плавное раскрытие и запасной вариант

Результат

Нажмите на заголовок и сравните три варианта: строка с высотой меняется плавно только в третьем. Если в браузере нет interpolate-size, высота меняется сразу, а прозрачность по-прежнему анимируется.

Тег details в JavaScript: свойство open и событие toggle

Состоянием блока управляют свойство open и событие toggle.

Свойство open читает и записывает атрибут: после details.open = true атрибут в разметке появляется сразу, а событие toggle приходит чуть позже. В обработчике доступны event.oldState и event.newState со значениями closed и open. Событие не всплывает, поэтому обработчик на внешнем элементе не получит событие вложенного блока. Для всех блоков страницы подходит перехват на документе с третьим аргументом true.

JavaScript
document.addEventListener('toggle', (e) => {
  if (e.target.matches('details')) {
    console.log(e.target.open, e.oldState, e.newState);
  }
}, true);

document.querySelector('details').open = true;

Событие приходит и при загрузке страницы, если у блока записан open, и при раскрытии по ссылке или поиску. Атрибут ontoggle в разметке работает так же, как обработчик из скрипта.

Отменить раскрытие через beforetoggle нельзя: у details это событие не приходит, в отличие от popover и dialog. Чтобы запретить смену состояния по клику, вызывают preventDefault() у события click на summary: клик, Enter и Space перестают переключать блок, а open = true из скрипта по-прежнему работает.

Пример: события toggle у блоков одной группы

Результат

Откройте блок A, затем B: сначала приходит toggle открытого блока, потом закрытого соседа по группе. Счётчик beforetoggle показывает, приходит ли это событие у details в вашем браузере.

Тег details и доступность: клавиатура и закрытое содержимое

Раскрывающийся блок работает с клавиатуры без скриптов, но у закрытого содержимого есть свои правила.

Заголовок summary получает фокус клавишей Tab, а Enter и Space переключают блок. Клик по содержимому блок не закрывает. В структуре доступности details определяется как группа, а заголовок как элемент раскрытия с состоянием «развёрнут» или «свёрнут».

Содержимое закрытого блока в структуру доступности не попадает: ссылка внутри не получает фокус от Tab, а focus() из скрипта не срабатывает и блок не открывает. Поэтому текст, который нужен всем сразу, в закрытый блок не прячут.

HTML
<details>
  <summary>Тарифы</summary>
  <a href="/tarify.html">Все тарифы</a>
</details>

Для выпадающего меню details не подходит: Esc и клик вне блока его не закрывают, а для такого закрытия нужен свой скрипт.

Пример: фокус на ссылке в закрытом и открытом блоке

Результат

Пока блок закрыт, ссылка внутри не видна и не получает фокус, а сам блок от focus() не открывается. Откройте блок и нажмите кнопку ещё раз: теперь ссылка принимает фокус.

Почему тег details не работает

Причину чаще всего ищут в группе name, в закрытом содержимом или в стилях.

Что видноПричинаЧто сделать
Блок закрывается сам, когда открывают другойУ блоков одинаковое значение nameДать блокам, которые должны открываться вместе, разные значения или убрать атрибут
Ссылка на блок не раскрывает егоСсылка ведёт на сам detailsЗаписать id элементу внутри содержимого и вести ссылку на него
После scrollIntoView() блок закрытПрокрутка не меняет состояниеПеред вызовом записать open = true ближайшему details
Форма с required не отправляется, ошибки не видноОбязательное поле находится в закрытом блокеРаскрывать блок в обработчике события invalid
Закрытие блока без анимацииВ transition нет content-visibility со значением allow-discreteДобавить его в список переходов
Высота меняется скачкомБраузер не знает interpolate-sizeОставить анимацию прозрачности как запасной вариант
Правило для ::details-content не действуетСтарая версия браузера: селектор появился в 2024 и 2025 годахЗадать оформление самому details и элементам внутри
Меню на details не закрывается по EscБлок сам не следит ни за клавишей, ни за кликом вне негоНе использовать details для меню или закрывать его скриптом
JavaScript
const city = document.querySelector('#city');
city.addEventListener('invalid', () => {
  city.closest('details').open = true;
});

Пример: форма с обязательным полем в закрытом блоке

Результат

Без флажка кнопка ничего не делает: поле внутри закрытого блока не получает фокус и сообщение об ошибке не показывается. С флажком обработчик invalid раскрывает блок, и поле получает фокус.

Частые ошибки с тегом details

Эти записи выглядят рабочими, но ведут себя иначе, чем ожидается.

ОшибкаЧто происходитКак исправить
Одинаковый name у вложенных блоковОткрытие вложенного блока закрывает внешнийЗаписать вложенному блоку другое значение name
Обработчик toggle на внешнем блокеСобытие вложенного блока до внешнего не доходит: оно не всплываетДобавить третий аргумент true или слушать документ
Ссылка на id самого detailsБлок остаётся закрытымВести ссылку на элемент внутри содержимого
details { display: flex; }Заголовок и содержимое выстраиваются в одну строкуОставить display по умолчанию, раскладку делать внутри div
transition: block-size .4sБлок открывается плавно, а закрывается мгновенноДобавить в переход content-visibility с allow-discrete
preventDefault() в beforetoggleСобытие не приходит, блок всё равно переключаетсяОтменять click у summary
Категория
Поделиться в социальных сетях
Основные HTML-теги
Семантические теги HTML
Заголовки и абзацы
Теги для форматирования текста
Тег гиперссылки HTML
HTML-теги таблицы
Списки в HTML
Теги для форм
Мультимедиа и изображения
Интерактивные и служебные теги
Устаревшие HTML-теги

Отправить комментарий

0 Комментарии

Отправить комментарий (0)

#buttons=(Хорошо) #days=(20)

Мы используем файлы cookie для улучшения работы сайта. Подробнее
Хорошо
×