Figma 手风琴折叠面板与自适应输入框对接 CSS interpolate-size、calc-size() 与 field-sizing: content 工程化交付实战
在日常搭建后台表单、FAQ 帮助中心与 AI 对话窗口时,设计师在 Figma 自动布局(Auto Layout) 中只需把子容器的垂直尺寸设为 Hug contents,再搭配 组件变体(Variants) 的展开/收起状态和 Smart Animate,几秒钟就能做出丝滑的手风琴折叠面板(Accordion)或“随着文字输入行数增多而自动增高”的聊天输入框。
然而到了前端代码交付阶段,这两类看似最基础的组件却往往让工程师大呼头疼:
- 折叠动画痛点:传统 CSS 无法在
height: 0与height: auto(即 Figma 中的Hug contents)之间做关键帧插值动画,前端要么被迫使用max-height: 9999px这种容易导致缓动时间失真的“魔数硬撑”,要么引入 JS 实时读取element.scrollHeight并内联写入像素高度。 - 自适应输入框痛点:原生 HTML 的
<textarea>、<input>和<select>默认高度或宽度是写死的(如rows="3"),无法像 FigmaHug contents那样随文本内容自适应缩放,传统工程中不得不挂载onInput事件并重排 DOM 测量高度。
随着现代浏览器逐步落地 CSS interpolate-size: allow-keywords、calc-size() 与 field-sizing: content 三大原生特性,Figma 的 Hug contents 与 Min/Max 尺寸约束终于可以零 JS、1:1 无损映射为原生 CSS。
一、传统前端妥协方案 vs 现代原生 CSS 交付对比 #
在 Dev Mode(开发模式) 进行研发交接前,产研团队应明确“何时淘汰 JS 测高与魔数 Hack”,建立统一的现代 CSS 交付契约:
| 交互场景 | 传统前端妥协方案 | 现代原生 CSS 交付方案 | 与 Figma 属性的映射关系 |
|---|---|---|---|
| 手风琴 / 折叠面板展开收起 | max-height: 0 -> 2000px(收起延迟、曲线畸变)或 JS 读写 scrollHeight | interpolate-size: allow-keywords 配合 height: 0 -> auto 或 <details>::details-content | 对应 Figma 变体 Expanded=False (Height: 0.01px) 到 Expanded=True (Hug) |
| 展开后需额外计算增量高度 | JS 读取 scrollHeight 后手动 + 24 再赋值内联样式 | height: calc-size(auto, size + 24px) 原生安全参与动画插值 | 对应展开态需要叠加固定底部留白或动态安全缓冲区的容器 |
| AI 对话框 / 多行评论输入 | 监听 input 事件重置 height: auto 再设为 scrollHeight + px(易触发布局抖动) | field-sizing: content + min-block-size / max-block-size | 对应 Figma 输入框容器 Height: Hug 并开启 Min Height 与 Max Height |
| 内联标签输入 / 自适应下拉框 | 创建隐藏 <span> 镜像测宽再同步给 <input> | field-sizing: content + min-inline-size / max-inline-size | 对应 Figma 文本输入框水平方向 Hug contents 配合 Min/Max Width |
二、实操一:在 Figma 中规范“可折叠”与“内容自撑”组件架构 #
要让原生 CSS 属性准确接管动画与尺寸自适应,设计师在 Figma 画布中不能随便套几层 Group 了事,必须严格遵守以下三项结构规范:
1. 手风琴组件(Accordion):严禁把内边距写死在被裁切的折叠壳子上 #
很多设计师在做手风琴变体时,喜欢直接把 padding: 16px 设在即将收起到 0px 的 Accordion_Content 容器上。在 CSS 中,如果一个容器既有 padding-top / padding-bottom,又要把 height 动画到 0px,收起瞬间外层的 padding 会导致容器卡在 32px 高度无法彻底归零,或者文字贴边骤然跳变。
- 建立双层嵌套结构:
- 动画裁切壳(
Accordion_Panel):垂直 Auto Layout,内边距Padding必须全部设为0,开启Clip content。收起态高度设为Fixed (0.01px)(Figma 不允许框高为绝对 0,常规使用0.01px或极小值配合Opacity: 0%),展开态设为Hug contents。 - 内层真实内容(
Accordion_Body):宽度Fill container,高度Hug contents,所有的文字间距与上下内边距(如padding: 0 16px 16px)全部放在这一层内部。
- 动画裁切壳(
- 对齐缓动曲线与状态命名:在 原型交互 中配置
Smart Animate,将时长统一绑定或标注为设计系统标准动效令牌(例如240ms cubic-bezier(0.22, 1, 0.36, 1),避免使用过高回弹的弹簧曲线导致折叠文字底部轻微露白),并在组件变体注释中明确标记CSS: interpolate-size: allow-keywords。
2. 自适应多行输入框(Auto-Growing Textarea):必须封死 Min 与 Max 极限边界 #
在 Figma 最新版 Auto Layout 中,任意设置 Hug contents 的 Frame 都可以点击尺寸输入框下拉菜单,单独添加 Add min height、Add max height、Add min width 与 Add max width。
- AI 聊天栏 / 多行评论输入框:
- 将文本图层设为
Fill container(宽度随容器换行)+Hug contents(高度随行数增长)。 - 外层输入框容器设为垂直/水平 Auto Layout,
Height: Hug,并强制添加Min height = 44px(单行起步高度)与Max height = 160px(约 5~6 行封顶)。 - 在超长文本变体中,将外框改为
Fixed = 160px并开启Overflow: Vertical scrolling,演示“超出上限后内部出现滚动条而非把整个页面顶爆”。
- 将文本图层设为
- 单行自适应宽度
<input>/<select>:- 将文本节点宽度设为
Hug contents,外框增加Min width = 80px与Max width = 280px,并在 Dev Mode 注明溢出截断规则(如失焦后text-overflow: ellipsis)。
- 将文本节点宽度设为
三、实操二:现代 CSS 零 JS 工程化交付代码模板 #
前端工程师在 Dev Mode 检查上述规范后,可直接套用以下三组生产级代码模板,彻底移除 scrollHeight 测量钩子与 max-height 魔数。
模板 1:全局启用 interpolate-size 实现手风琴与 <details> 丝滑折叠 #
在设计系统全局 Reset 样式中声明 interpolate-size: allow-keywords 后,整个文档树中的 height、min-height、block-size 都支持在 0 与 auto / fit-content 之间进行原生插值动画:
/* 1. 在 :root 声明允许关键字尺寸插值(支持继承,不影响未设 transition 的普通元素) */
:root {
interpolate-size: allow-keywords;
}
/* 2. 原生 HTML <details> 手风琴零 JS 平滑展开收起(1:1 映射 Figma Accordion 双层壳规范) */
.ds-accordion {
border-bottom: 1px solid var(--ds-border-subtle);
}
.ds-accordion::details-content {
block-size: 0;
opacity: 0;
overflow: clip;
/* 同时对 block-size、opacity 与 content-visibility 做协调过渡 */
transition:
block-size 0.24s cubic-bezier(0.22, 1, 0.36, 1),
opacity 0.2s ease,
content-visibility 0.24s allow-discrete;
}
.ds-accordion[open]::details-content {
block-size: auto;
opacity: 1;
}
/* 内层真实内容承载所有 Padding,避免折叠到 0 时内边距卡顿 */
.ds-accordion-body {
padding: 0 16px 16px;
color: var(--ds-text-secondary);
}
模板 2:用 calc-size() 实现“展开高度 + 动态呼吸留白”或半折叠预览 #
当设计稿要求面板展开时比纯内容 auto 多留出 24px 底部安全区,或者要求未展开时默认显示前 64px 摘要、点击后平滑展开至完整高度时,必须使用 calc-size()(interpolate-size 无法直接用于 calc() 内部与 auto 运算,而 calc-size() 可以):
/* 支持从固定摘要预览高度(64px)平滑插值到“完整内容高度 + 24px 底部留白” */
.expandable-note {
overflow: clip;
block-size: 64px;
transition: block-size 0.28s cubic-bezier(0.22, 1, 0.36, 1);
}
.expandable-note[data-expanded="true"] {
/* size 代表解析后的 auto 真实内容高度,可安全执行加减运算 */
block-size: calc-size(auto, size + 24px);
}
模板 3:field-sizing: content 零 JS 实现 AI 自增高输入框与内联选择器 #
以下 CSS 直接对应 Figma 中配置了 Hug 与 Min/Max 极值边界的输入控件:
/* 1. AI 对话框 / 多行评论输入:对应 Figma Min-H: 44px, Max-H: 160px */
.ds-auto-textarea {
field-sizing: content;
inline-size: 100%;
min-block-size: 44px;
max-block-size: 160px;
padding: 10px 14px;
line-height: 1.5;
resize: none;
overflow-y: auto; /* 超出 160px 后自动启用内部滚动条 */
border: 1px solid var(--ds-border-default);
border-radius: var(--ds-radius-md);
}
/* 2. 行内重命名输入与内容自适应 Select:对应 Figma Min-W: 80px, Max-W: 280px */
.ds-inline-input,
.ds-auto-select {
field-sizing: content;
min-inline-size: 80px;
max-inline-size: 280px;
padding: 6px 10px;
}
四、浏览器渐进增强兜底与设计走查(Design QA)清单 #
虽然 Chromium 内核(Chrome / Edge 129+)已全面支持上述属性,但面对 Safari 或企业内网旧版浏览器时,必须在交付阶段做好渐进增强(Progressive Enhancement)与走查校验:
| 验收检查项 | 常见工程隐患 | 标准化解决方案与 Figma 兜底配置 |
|---|---|---|
旧浏览器不支持 field-sizing | <textarea> 在 Safari 旧版本退化为默认 2 行小框,空态高度过窄 | 始终显式声明 min-block-size: 44px 与合理的 HTML rows="2" 属性;对强依赖多行动态撑高的旧端场景,利用 @supports not (field-sizing: content) 按需挂载轻量 JS 兜底 |
空值 <input> 缩成一根竖线 | 设置 field-sizing: content 后若忘记设 min-inline-size,空输入框宽度会坍缩到仅剩光标宽 | 在 Figma 和 CSS 中永远成对交付 Hug 与 Min Width / Min Height,杜绝无下限的自适应框 |
| 手风琴收起时文字闪现溢出 | 忘记加 overflow: clip 或使用 overflow: hidden 破坏内部粘性元素 | 折叠外壳统一使用 overflow: clip 搭配 content-visibility 离散过渡,兼顾零残影与渲染性能 |
| 展开收起动画前后布局卡顿 | 内部同时存在 border 或大面积 box-shadow 重绘 | 将投影和边框放在最外层静止容器中,动画仅作用于纯文本包裹壳的 block-size 与 opacity |
五、延伸阅读与站内参考 #
- 父子联动进阶:搭配 Figma 交互组件变体对接现代 CSS :has() 父选择器工程化交付实战,实现零 JS 的表单校验高亮与卡片联动选中。
- 网格与文本折行:阅读 Figma Auto Layout 进阶与现代 CSS Subgrid / Intrinsic Sizing 工程化交付实战,掌握
min-content/fit-content与卡片等高对齐。 - 物理动效转换:查阅 Figma 原型动效参数与前端代码工程化交付实战,了解 Figma 缓动曲线与
cubic-bezier()精确换算规则。 - 常见疑难排障:遇到 Auto Layout 嵌套溢出错位或画布性能卡顿时,可参考 Figma 常见报错与疑难故障诊断手册。
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。