Тег details (от английского details, «подробности») создаёт блок, который раскрывается и сворачивается по клику без JavaScript. Первым потомком записывают заголовок summary, а состояние хранит булев атрибут open. Закрывающий </details> обязателен. Остальное содержимое видно только в раскрытом блоке.
Если нужен только готовый рабочий блок, хватит урока «Раскрывающийся блок: details и summary». В статье разобраны атрибуты open и name, раскрытие блока при поиске и по ссылке-якорю, стили и анимация через ::details-content, события и свойства в JavaScript, доступность и причины, по которым блок не работает. Заголовок блока и его маркер собраны на странице про тег summary, а другие теги группы в справочник по тегам.
<details>
<summary>Как оформить возврат</summary>
<p>Заявку подают в течение 14 дней после покупки.</p>
</details>
В этой статье
- Тег details в HTML: что это и для чего нужен
- Атрибуты тега details: open, name и глобальные
- Атрибут name тега details: группа с одним открытым блоком
- Тег details и поиск по странице: Ctrl+F и ссылка-якорь
- Стили тега details: рамка, отступы и ::details-content
- Анимация тега details: плавное раскрытие блока
- Тег details в JavaScript: свойство open и событие toggle
- Тег details и доступность: клавиатура и закрытое содержимое
- Почему тег details не работает
Тег details в HTML: что это и для чего нужен
Раскрывающийся блок собирается из двух тегов, а его состояние хранит один булев атрибут.
Тег details парный: закрывающий </details> обязателен. Если его пропустить, всё, что записано после блока, окажется внутри него. Первым потомком записывают summary: его текст виден всегда и работает как заголовок. Остальное содержимое выводится только в раскрытом состоянии, а в закрытом браузер его не отображает.
Состояние блока записано в атрибуте open. Пока его нет, блок закрыт. Клик по заголовку, клавиши Enter и Space переключают блок, и браузер сам добавляет или убирает open в разметке. У самого details нет ни стрелки, ни текста: маркер и надпись выводит summary.
<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», а здесь разобрано, когда браузер закрывает соседей и где группа ведёт себя неочевидно.
<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 и ссылка-якорь
Содержимое закрытого блока не выводится, но поиск и переходы по ссылкам умеют его раскрывать.
<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 годах, а в более старых версиях правило не срабатывает, и блок выглядит как раньше.
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). Если нажать на заголовок посреди анимации, блок плавно возвращается назад.
@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.
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() из скрипта не срабатывает и блок не открывает. Поэтому текст, который нужен всем сразу, в закрытый блок не прячут.
<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 для меню или закрывать его скриптом |
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 |