使用 tailwind css 实现纯 css 手风琴效果,核心在于利用 html5 原生的 和 标签,配合 tailwind 的 group 和 peer 类名来管理状态。当用户点击 时,浏览器会自动切换 open 属性,通过 group-open: 前缀可以控制内部内容的显示与隐藏动画。

如何定义手风琴的基础结构与样式
基础结构由一个容器包裹多个 元素组成。每个 代表一个折叠项,其内部的 是可见的标题部分,其余内容则是可折叠的主体。为了实现平滑过渡,需要给主体内容设置固定的高度或最大高度,并利用 grid 布局的 grid-rows-[0fr] 到 grid-rows-[1fr] 技巧来实现高度从 0 到 auto 的动画效果。

<details></details>
上述代码创建了一个包含两个项目的简单手风琴。第一个项目默认展开,因为 标签没有 open 属性时默认为关闭,但为了演示,我们可以移除第二个项目的 open 属性(如果有的话),或者保持默认关闭状态。在实际使用中,通常所有项默认都是关闭的,除非显式添加 open 属性。这里为了展示效果,假设初始状态为关闭。点击标题会触发展开/收起动画,箭头图标也会随之旋转。
如何实现互斥展开(一次只展开一项)
虽然问题要求纯 CSS,但标准的 标签允许同时展开多个项。如果需要实现“手风琴”常见的互斥效果(即展开一项时自动关闭其他项),通常需要少量的 JavaScript。然而,如果严格限制在纯 CSS,我们无法实现真正的互斥逻辑,因为 CSS 无法监听兄弟元素的 open 状态并修改其他元素。因此,所谓的“纯 CSS 手风琴”通常指的是视觉上的折叠展开效果,而非行为上的互斥。如果必须实现互斥,建议引入极简的 JS 脚本。但在本例中,我们将专注于视觉效果的实现,并说明互斥行为的局限性。

<!-- 注意:纯 CSS 无法实现互斥,以下仅为视觉结构示例 -->
<div class="space-y-4">
<details class="group bg-white rounded-lg shadow-sm border border-gray-200 open:shadow-md transition-shadow duration-300"><summary class="flex items-center justify-between p-6 cursor-pointer list-none select-none"><span class="font-semibold text-gray-800 group-open:text-blue-600 transition-colors duration-300">选项 A</span>
<svg class="w-5 h-5 text-gray-500 group-open:rotate-180 transition-transform duration-300" fill="none" stroke="currentColor" viewbox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"></path></svg></summary><div class="overflow-hidden grid grid-rows-[0fr] group-open:grid-rows-[1fr] transition-[grid-template-rows] duration-300 ease-in-out">
<div class="min-h-0 p-6 pt-0 text-gray-600 leading-relaxed">
这是选项 A 的内容。如果使用纯 CSS,用户可以同时打开选项 B 和 C。
</div>
</div>
</details><details class="group bg-white rounded-lg shadow-sm border border-gray-200 open:shadow-md transition-shadow duration-300"><summary class="flex items-center justify-between p-6 cursor-pointer list-none select-none"><span class="font-semibold text-gray-800 group-open:text-blue-600 transition-colors duration-300">选项 B</span>
<svg class="w-5 h-5 text-gray-500 group-open:rotate-180 transition-transform duration-300" fill="none" stroke="currentColor" viewbox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"></path></svg></summary><div class="overflow-hidden grid grid-rows-[0fr] group-open:grid-rows-[1fr] transition-[grid-template-rows] duration-300 ease-in-out">
<div class="min-h-0 p-6 pt-0 text-gray-600 leading-relaxed">
这是选项 B 的内容。纯 CSS 方案下,它不会自动关闭选项 A。
</div>
</div>
</details>
</div>
这段代码展示了两个独立的手风琴项。用户点击“选项 A”会展开它,点击“选项 B”也会展开它,两者可以同时处于展开状态。如果需要互斥效果,必须使用 JavaScript 监听 toggle 事件并手动关闭其他 元素。例如:document.querySelectorAll('details').forEach(d => { if (d !== target) d.removeAttribute('open'); });。但在纯 CSS 约束下,我们只能提供这种非互斥的折叠展开视觉效果。
当使用 grid-rows 动画时,内容高度不确定如何处理
在使用 grid-rows-[0fr] 到 grid-rows-[1fr] 技巧进行高度动画时,如果内容高度不固定,可能会遇到动画结束后高度计算不准确的问题。这是因为 1fr 在网格布局中表示剩余空间,如果内容高度超过容器可用空间,可能会导致溢出或布局异常。为了解决这个问题,可以在内容外层包裹一个具有 min-h-0 的容器,并确保父级 div 没有设置固定高度。此外,可以使用 max-height 作为备选方案,但 grid 方法通常更流畅且支持任意高度。如果内容非常长,考虑添加滚动条或使用 overflow-y-auto 来限制可视区域。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











