html5的details/summary标签可原生实现手风琴效果，语义清晰且无需js；自定义方案则通过css过渡与js切换类名、动态测量高度或grid subgrid布局实现更精细控制，并需添加aria属性保障无障碍访问。
如果您希望在网页中实现点击标题展开内容、再次点击收起的交互效果，HTML5结合CSS和JavaScript可构建轻量、语义化且无需第三方库的手风琴菜单。以下是实现该效果的具体方法：
一、使用details与summary标签（原生HTML5方案）
HTML5原生提供了<details></details>和<summary></summary>标签，浏览器默认支持展开/收起交互，语义清晰、无需脚本、兼容性良好（Chrome 12+、Firefox 49+、Safari 6+、Edge 79+）。
1、在HTML中插入<details></details>容器，并在其内部嵌套<summary></summary>作为标题栏，其余内容作为展开区域。
2、确保<summary></summary>是<details></details>的第一个子元素，否则部分浏览器可能不识别点击区域。
立即学习“前端免费学习笔记（深入）”；
3、可通过CSS设置summary::marker隐藏默认三角符号，并自定义图标或样式。
4、添加open属性可使某个条目默认处于展开状态。
二、CSS过渡配合JavaScript控制类名（自定义动画方案）
该方案通过为内容区域设置固定高度与CSS过渡，利用JavaScript切换类名触发动画，实现平滑展开收起效果，兼容旧版浏览器且动画可控性强。
1、为每个手风琴项包裹在<div class="accordion-item">中，内含标题<code><button class="accordion-header"></button>与内容区<div class="accordion-content">。
<p>2、初始状态下，为<code>.accordion-content设置max-height: 0、overflow: hidden及transition: max-height 0.3s ease-in-out。
3、定义激活类.accordion-open，其中设置max-height为预估最大高度值（如500px）或使用fit-content（需配合height: auto与JS动态计算）。
4、为每个.accordion-header绑定click事件，切换相邻.accordion-content的.accordion-open类名。
三、JavaScript动态测量高度实现精准过渡（无硬编码方案）
避免因内容长度变化导致max-height设值不准而出现跳动或截断，此方案在点击时实时获取内容高度并应用为过渡目标值，保证动画自然流畅。
1、为每个.accordion-content添加data-accordion-target属性以建立与对应标题的关联。
2、点击标题时，先移除所有已展开项的active类，再判断当前目标是否已展开。
3、若未展开，调用getBoundingClientRect().height获取内容实际高度，将其赋值给style.maxHeight，随后添加active类触发过渡。
4、若已展开，立即将maxHeight设为0，并在transitionend事件中移除active类并清除maxHeight内联样式。
四、使用CSS Grid与subgrid模拟多级手风琴（结构化布局方案）
当需要呈现嵌套层级（如分类→子类→条目）时，可借助CSS Grid的subgrid特性维持对齐，配合JavaScript控制各层级显隐，保持视觉一致性与响应式稳定性。
1、外层容器启用display: grid并定义行轨道，每项占据一行，使用grid-template-rows: subgrid让子容器继承父轨道。
2、每项标题设置grid-row定位，对应内容区使用grid-row: span 2占位，初始visibility: hidden与opacity: 0。
3、展开时，将内容区设为visibility: visible、opacity: 1，并添加transform: translateY(0)配合过渡。
4、为防止高度塌陷影响网格布局，对内容区父容器设置min-height: 0并启用overflow: hidden。
五、无障碍增强：添加ARIA属性与键盘支持
确保手风琴菜单符合WCAG标准，支持屏幕阅读器与键盘操作（如Tab导航、Enter/Space触发），提升可访问性。
1、为.accordion-header添加role="button"、aria-expanded="false"及aria-controls="content-id"，指向对应内容区ID。
2、为.accordion-content添加role="region"、aria-labelledby="header-id"，建立语义关联。
3、监听keydown事件，在焦点位于标题上时，按下Enter或Space键触发展开/收起逻辑。
4、展开后自动将焦点移至内容区首子元素（如有），或保持焦点在标题上并更新aria-expanded状态。
