折叠面板、FAQ、侧边栏子菜单,都需要在「高度为零」和「内容自然高度」之间过渡。麻烦在于,内容可能换行、追加、加载图片,最终高度很难提前知道。
常见做法有四种:动画化 Grid 轨道、设置 max-height 上限、用 JavaScript 测量 height,以及通过新的 interpolate-size 直接启用固有尺寸插值。它们都能实现展开与收起,但需要维护的状态、运动曲线和兼容范围不同。
先看四种方案的效果

四个面板使用相同内容、1000ms 和 linear,循环展示展开与收起。max-height 的上限设为 600px,明显大于内容高度,因此它展开时先到终点,收起时先等待一段时间;另外三种方案在这次内容稳定、从一个端点到另一个端点的完整过渡中,可见高度变化覆盖设定的动画时长。下方灰色块始终处于正常文档流,便于观察布局的移动。注意:Grid 插值的是轨道系数,不是像素高度,因此即使同用 linear,中途高度也不一定与测量 height 的曲线相同。
可以打开交互演示页,同步切换四个面板,或追加内容。WebP 在支持 interpolate-size 的 Chromium 浏览器中录制;交互页会显示当前浏览器是否支持该能力,不支持时第四个面板直接展开或收起。演示卡片预留了完整展开空间,只有灰色的下方元素跟随实际高度移动,便于比较四种动画。
为什么直接写 height: auto 不行
传统 CSS 过渡擅长在两个数值之间插值,例如 height: 0px 到 height: 180px。默认情况下,auto 是由布局决定的关键字,不能直接参与这样的数值插值:
.panel {
height: 0;
overflow: hidden;
transition: height 300ms ease;
}
.panel.is-open {
height: auto;
}
仅靠这段代码,在没有额外启用相关新特性的环境中,不能得到预期的平滑高度动画。现代 CSS 已开始通过 interpolate-size: allow-keywords 支持长度与固有尺寸之间的过渡,后文再说它的适用范围。参见 MDN:interpolate-size。
方案一:Grid 的 0fr / 1fr 技巧
可直接使用的示例
<button id="trigger" type="button">
展开说明
</button>
<div id="panel" class="panel">
<div class="panel__clip">
<div class="panel__body">
<p>这里可以放任意长度的内容。</p>
<p>多一段文字、换行或改变屏幕宽度,无需修改目标高度。</p>
</div>
</div>
</div>
.panel {
display: grid;
grid-template-rows: 0fr;
transition: grid-template-rows 300ms ease;
}
.panel.is-open {
grid-template-rows: 1fr;
}
.panel__clip {
min-height: 0;
overflow: hidden;
}
.panel__body {
padding: 16px;
}
.panel__body p {
margin: 0 0 12px;
}
const trigger = document.querySelector('#trigger');
const panel = document.querySelector('#panel');
trigger.addEventListener('click', () => {
const open = panel.classList.toggle('is-open');
trigger.textContent = open ? '收起说明' : '展开说明';
});
这里 JavaScript 只管理状态,没有读取或写入高度;动画完全由 CSS 处理。单实例示例把脚本放在 HTML 之后执行。下文四种方案的 CSS 是替代关系,切换方案时要替换上一组规则,避免残留的 Grid、height 或 max-height 约束互相影响。
1fr 没有固定容器高度,为什么也能展开
fr 是轨道的弹性系数,不能简单理解成百分比。在这个容器高度由内容决定、只有一个显式行轨道的场景里,浏览器利用内容的固有尺寸求出弹性轨道大小;1fr 能容纳完整内容,0fr 则可以把轨道压到零。
过渡时,浏览器在两个弹性系数之间插值,再根据轨道算法求出每一帧的布局。这不是把 auto 转成一个 CSS 数字,而是动画化 Grid 的轨道尺寸。Grid 轨道插值的背景可参考 web.dev:CSS animated grid layouts,尺寸计算细节见 CSS Grid 规范。
这套解释依赖上述结构。给外层设置固定高度、放入多个直接子元素产生隐式行,或者让轨道数量在两端发生变化,都可能改变结果。常见折叠面板应保持一个直接子元素,用它包住全部内容。
真正容易漏掉的是内层
只有 0fr 不一定能彻底收起。Grid 项目的自动最小尺寸可能阻止它缩小,内容还可能绘制到轨道之外。因此内层同时设置:
min-height: 0:明确允许项目缩小overflow: hidden:裁掉轨道之外的内容
把 padding 放在更深一层的 .panel__body,不要放在外层 Grid 或承担收缩的 .panel__clip 上。否则 padding、border、最小高度等盒模型约束可能让收起状态残留空白。如果增加多个轨道,还要注意 gap 会额外占用空间,轨道收缩到零并不等于整个容器为零;本文采用单轨道结构。
也不要在收起时加 display: none 或 hidden,它们会直接移除布局盒,让这段轨道过渡失去对象。
优点与边界
Grid 不需要估算高度上限,也不需要测量 DOM;内容多少不同,仍可以使用相同的动画时长。窗口宽度变化时,展开状态自然重新布局。动画过程中再次切换,CSS 会从当前插值状态向新目标过渡,通常比手工维护高度更省心。不过反向过渡可能按 CSS 的反向缩短规则提前结束,不能保证每次快速点击都重新运行完整的 300ms。参见 CSS Transitions 规范:反向过渡。
但「动态高度」不等于「任意内容变化都会自动平滑」。面板已经处于 1fr 时,追加文字、图片加载或字体变化,只是重新计算布局,没有一次新的 0fr → 1fr 状态变化,通常会直接改变高度。在动画途中改变内容,也可能改变运动轨迹。
此外,Grid 高度动画会触发布局;去掉 JavaScript 测量并不意味着动画自动由 GPU 合成,也不保证一定比其他方案快。大段复杂内容、多个面板同时动画时,仍应在目标设备上测量。
方案二:用 max-height 设一个足够大的上限
.panel {
max-height: 0;
overflow: hidden;
transition: max-height 300ms ease;
}
.panel.is-open {
max-height: 600px;
}
.panel__body {
padding: 16px;
}
.panel__body p {
margin: 0 0 12px;
}
沿用前面的 HTML 和按钮状态逻辑即可;中间的 .panel__clip 在这一方案里只是普通包装层,可以去掉。padding 仍放在内容内层。
它的优点是代码少、历史兼容性好,也不需要测量高度。缺点是上限必须提前给定:太小会裁剪内容,太大则让运动节奏失真。
设置的时长,不等于看得见的时长
假设内容高度为 H = 180px,上限为 M = 600px,动画时长 T = 1000ms,使用 linear。
展开时,可见高度近似为:
visibleHeight(t) = min(H, M × t / T)
所以只需要 T × H / M = 300ms,内容就已经完全展开,剩余 700ms 仍在动画化 max-height,视觉上却没有高度变化。
收起时,上限先从 600px 减到 180px,这段 700ms 内容保持完整高度;最后 300ms 才开始看得见的收缩。使用 ease 后比例不能直接按时间线性计算,但提前停止和延迟开始的问题仍在。
这里假设外层没有额外 padding、border 等干扰,内容高度在过程中保持不变。把上限改成 9999px 只会进一步放大偏差。如果用 JavaScript 测量后精确设置上限,就已经引入了测量方案的维护成本。
方案三:测量真实高度,再动画化 height
思路是把未知高度转换成像素:展开时从当前可见高度过渡到内容的完整高度,结束后恢复 auto;收起时先把 auto 冻结成当前像素高度,再过渡到 0。
下面沿用方案一的 HTML,用这组 CSS 替换 Grid 样式,并替换按钮脚本。示例假设没有从祖先继承 interpolate-size: allow-keywords,展开完成后恢复 auto 不会触发第二次高度过渡:
.panel {
height: 0;
overflow: hidden;
transition: height 300ms ease;
}
.panel__body {
padding: 16px;
}
.panel__body p {
margin: 0 0 12px;
}
const trigger = document.querySelector('#trigger');
const panel = document.querySelector('#panel');
const content = panel.querySelector('.panel__body');
let open = false;
function setOpen(next) {
// 先读取当前可见高度,快速反向切换时也从当前画面继续
const current = panel.getBoundingClientRect().height;
const target = next ? content.getBoundingClientRect().height : 0;
panel.style.transition = 'none';
panel.style.height = `${current}px`;
// 提交起始布局,避免起点与终点被浏览器合并
void panel.offsetHeight;
panel.style.transition = '';
open = next;
trigger.textContent = next ? '收起说明' : '展开说明';
if (Math.abs(current - target) < 0.5) {
panel.style.height = next ? 'auto' : '0px';
} else {
panel.style.height = `${target}px`;
}
}
panel.addEventListener('transitionend', event => {
// 子元素也可能产生 transitionend,只处理自己的 height
if (event.target !== panel || event.propertyName !== 'height') return;
if (open) panel.style.height = 'auto';
});
trigger.addEventListener('click', () => setOpen(!open));
示例假设外层没有 padding、border,内容不带 transform 和外边距,高度由 .panel__body 完整提供。getBoundingClientRect() 得到包含 padding 和 border 的边框盒尺寸,可以保留小数。
另一种常见写法是 panel.scrollHeight,它包含 padding、不包含 border,返回整数;不能不考虑盒模型就把任何元素的 scrollHeight 原样写入 height。具体定义见 MDN:Element.scrollHeight。
控制力更强,状态也更多
测量方案的目标高度准确,没有随意上限,动画时长可预测。示例在展开结束后恢复 auto,后续换行和追加内容不会被旧像素高度裁剪。数字高度过渡本身也有很成熟的兼容性。
代价是管理测量、起始布局、反向切换和动画结束事件。示例中的布局读取与强制提交可能引发同步布局,不适合在大量元素上反复交错读写。
展开过程中图片加载、容器变宽或内容追加,原先测得的目标会失效;结束后恢复 auto 可能出现跳变。如果需要让这些变化也平滑,可以监听内层内容的 ResizeObserver,重新计算目标,并管理取消与清理。不要直接观察正在动画的外层后又持续改它的高度,以免形成反复回调。
示例覆盖普通点击和快速反向切换;如果组件会在动画中卸载、隐藏、修改过渡配置,还需要处理取消与生命周期清理。transitionend 在过渡取消或没有实际过渡时不会可靠地触发,不能把它当成唯一的状态完成保障,参见 MDN:transitionend。
方案四:用 interpolate-size 直接过渡到 auto
interpolate-size: allow-keywords 允许在长度与固有尺寸关键字之间插值。例如,直接让 height 从 0 过渡到 auto,浏览器负责求出内容高度,无需设定上限或测量 DOM。
沿用方案一的 HTML 和按钮状态脚本,使用下面的 CSS:
.panel {
height: 0;
overflow: hidden;
}
.panel.is-open {
height: auto;
}
.panel__body {
padding: 16px;
}
.panel__body p {
margin: 0 0 12px;
}
@supports (interpolate-size: allow-keywords) {
.panel {
interpolate-size: allow-keywords;
transition: height 300ms ease;
}
}
优点与边界
它直接表达「从零到自然高度」,CSS 很少,不需要 Grid 包装结构或 JavaScript 测量,展开后仍保持 auto,能够自然适应后续内容变化。和其他方案一样,展开后的内容变化通常只触发重新布局,不会凭空开始一次新过渡。
至少一端必须是长度或百分比,不能把它理解为任意两个固有尺寸关键字都可以互相动画。这个属性会继承,示例把启用范围限制在面板及其后代,避免影响整页其他组件;嵌套组件仍会继承它,必要时可用 interpolate-size: numeric-only 单独退出。高度变化仍会触发布局,不是仅在合成层完成。原理与限制参见 MDN:interpolate-size。
不支持时直接切换高度;支持时启用长度与固有尺寸插值。这是一套独立方案,不应直接叠加到前面的 Grid 或测量实现上。截至查询时,MDN 仍将 interpolate-size 标为兼容性有限,采用前应查看实时兼容表,不要直接替换需要跨浏览器保障的实现。
四种方案的兼容性
以下为截至 2026-10-14 查询的主流浏览器最低版本。数据来自 MDN Browser Compatibility Data 的 Grid 轨道动画、interpolate-size 和 CSS transition。数值过渡两行以本文使用的无前缀 transition 简写支持为门槛,不包含更早的前缀写法,也不表示整段 JavaScript 示例能在这些最低版本直接运行;测量方案还需单独确认所用 JavaScript API。表中的 Edge 只列 Chromium 版本,旧 EdgeHTML 也支持数值过渡,但不在这一列的范围内。
| 能力 | Chrome / Edge(Chromium) | Firefox | Safari / iOS Safari |
|---|---|---|---|
能力Grid 的 0fr / 1fr 轨道动画 |
Chrome / Edge(Chromium)107+ / 107+ | Firefox66+ | Safari / iOS Safari16+ / 16+ |
能力max-height 数值过渡 |
Chrome / Edge(Chromium)26+ / 79+ | Firefox16+ | Safari / iOS Safari9+ / 9+ |
能力测量后 height 数值过渡 |
Chrome / Edge(Chromium)26+ / 79+ | Firefox16+ | Safari / iOS Safari9+ / 9+ |
能力interpolate-size: allow-keywords |
Chrome / Edge(Chromium)129+ / 129+ | Firefox不支持 | Safari / iOS Safari不支持 / 不支持 |
Android Chrome / Android System WebView 需达到对应 Chromium 能力;iOS 上的 WebView 还应结合实际系统和容器版本验证。IE 不支持本文的现代 Grid 轨道动画;若仍维护旧环境,可选数值高度方案,但示例中的现代 JavaScript 仍需另外适配。
较早的浏览器可能支持 Grid 布局,却不支持轨道平滑插值,展开收起仍可能正常切换,只是没有动画。@supports (grid-template-rows: 0fr) 或 CSS.supports() 检查的是声明支持,不能证明轨道可动画。需要按最低目标浏览器实测,或接受无动画降级;完全不支持现代 Grid 的环境应额外提供普通的显示与隐藏样式。
四种方案怎么选
| 维度 | Grid 0fr / 1fr | max-height | 测量 height | interpolate-size |
|---|---|---|---|---|
| 维度是否需要预估上限 | Grid 0fr / 1fr不需要 | max-height需要 | 测量 height不需要 | interpolate-size不需要 |
| 维度是否读取 DOM 高度 | Grid 0fr / 1fr不需要 | max-height不需要 | 测量 height需要 | interpolate-size不需要 |
| 维度内容稳定时的完整端点过渡 | Grid 0fr / 1fr覆盖设定时长,轨迹取决于布局 | max-height可见时长受内容与上限比例影响 | 测量 height覆盖设定时长 | interpolate-size覆盖设定时长 |
| 维度展开后适应内容变化 | Grid 0fr / 1fr自然重新布局 | max-height超出上限裁剪 | 测量 height恢复 auto 后可以 | interpolate-size保持 auto,自然重新布局 |
| 维度内容变化自动平滑 | Grid 0fr / 1fr不保证 | max-height不保证 | 测量 height需额外监听和控制 | interpolate-size不保证 |
| 维度实现成本 | Grid 0fr / 1fr少量 CSS,需内层结构 | max-height最少,但有上限与节奏偏差 | 测量 height较多,需维护状态与测量 | interpolate-size少量 CSS,语义直接 |
| 维度兼容范围 | Grid 0fr / 1fr主流现代浏览器 | max-height数值过渡成熟 | 测量 height数值过渡成熟,另查 API | interpolate-size目前主要是 Chromium 129+ |
普通 FAQ、菜单和文字折叠面板,目标环境满足兼容要求时,Grid 通常是简洁的选择。内容高度范围明确、动画精度要求较低时,max-height 仍够用。需要精确控制、协调多个动画,或让展开后的内容尺寸变化也平滑时,测量方案更灵活。
允许无动画降级或主要面向较新 Chromium 时,也可以使用 interpolate-size;需要覆盖 Firefox 和 Safari 时,仍应保留其他实现或直接切换的回退。
四者都会改变正常文档流里的实际布局高度。transform: scaleY() 虽然常能减少布局工作,却不会让下方元素随着可见内容高度移动,还会压缩文字,因此不属于同样的替代方案。