details 元素原生支持可折叠时间轴节点,语义正确、轻量且可访问性好;需每个节点单独包裹,summary 作标题,内容放内部;多级嵌套或需动画/联动时须用 JS 配合 ARIA 控制。

用 details 和 summary 最快实现可折叠时间轴节点
原生 HTML 就支持,不用 JS 也能做,但得注意默认样式和语义限制。details 天然适合「节点展开/收起」这种单层切换场景,比手写 display: none + JS 切换更轻量、可访问性更好。
常见错误是直接套在 div 时间轴容器上,结果整个时间轴一起折叠——details 必须每个节点单独包裹:
<details> <summary>2023-06</summary> <p>上线了用户标签系统</p> </details> <details> <summary>2024-01</summary> <p>重构了权限模块</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p> </details>
-
summary内容会自动变成可点击的折叠控件,不能用span替代 - 默认带小三角图标,CSS 可通过
summary::marker覆盖,但 Safari 旧版不支持 - 如果时间轴需支持多级嵌套(比如某节点下还有子事件),
details不适用,得切到 JS 方案
用 JS 控制 classList 实现自定义折叠逻辑
当需要动画、联动控制(如只允许一个节点展开)、或兼容 IE 时,就得手动管理状态。核心是切换节点容器的 data-expanded 属性或 aria-expanded,再配合 CSS 过渡。
关键点不是「怎么加 class」,而是「什么时候加」:必须监听 click,且要阻止 summary 默认行为(否则 details 会抢事件);若完全不用 details,则直接操作目标节点的 max-height 或 height。
- 用
max-height做过渡比height更安全,避免内容高度不确定时动画失效 - 记得给展开态的容器加
aria-expanded="true",屏幕阅读器依赖这个 - 多个节点共存时,别用
document.querySelector('.timeline-item')硬写,改用event.currentTarget.parentElement定位当前节点
CSS 动画折叠时内容被截断怎么办
典型现象:点击展开后,文字只显示半行,或者底部被裁掉。根本原因是 overflow: hidden 配合 max-height 过渡时,设定的 max-height 值小于内容实际高度。
解决方法不是盲目调大数值,而是用「内容驱动」策略:
- 展开前先用
element.scrollHeight测高,再设为max-height,收起时再设回0 - 如果不想 JS 测高,可用
height: auto+opacity组合过渡,牺牲高度动画但保内容完整 - 绝对定位的子元素(如右上角「编辑」按钮)不受
max-height影响,可能溢出,需额外加overflow: hidden到父容器
时间轴节点折叠后语义结构还成立吗
不加处理就折叠,会导致 DOM 结构断裂。比如用 display: none 直接隐藏内容,screenreader 会跳过整块信息;用 visibility: hidden 则仍占读屏焦点顺序。
正确做法始终围绕 ARIA 规范:
- 每个可折叠节点外层加
role="region",并用aria-labelledby指向对应的summary元素 ID -
summary元素必须有role="button"和tabindex="0"(若没用原生details) - 不要仅靠视觉样式(如颜色变灰)表示「已展开」,必须同步更新
aria-expanded布尔值
最易被忽略的是键盘操作:Enter/Space 键必须触发展开,且焦点要留在 summary 上——这点纯 CSS 方案做不到,必须 JS 补齐。



















