Figma 手风琴折叠面板与自适应输入框对接 CSS interpolate-size、calc-size() 与 field-sizing: content 工程化交付实战

2026 年 11 月 22 日

在日常搭建后台表单、FAQ 帮助中心与 AI 对话窗口时,设计师在 Figma 自动布局(Auto Layout) 中只需把子容器的垂直尺寸设为 Hug contents,再搭配 组件变体(Variants) 的展开/收起状态和 Smart Animate,几秒钟就能做出丝滑的手风琴折叠面板(Accordion)或“随着文字输入行数增多而自动增高”的聊天输入框。

然而到了前端代码交付阶段,这两类看似最基础的组件却往往让工程师大呼头疼:

  1. 折叠动画痛点:传统 CSS 无法在 height: 0 与 height: auto(即 Figma 中的 Hug contents)之间做关键帧插值动画,前端要么被迫使用 max-height: 9999px 这种容易导致缓动时间失真的“魔数硬撑”,要么引入 JS 实时读取 element.scrollHeight 并内联写入像素高度。
  2. 自适应输入框痛点:原生 HTML 的 <textarea>、<input> 和 <select> 默认高度或宽度是写死的(如 rows="3"),无法像 Figma Hug 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 高度无法彻底归零,或者文字贴边骤然跳变。

  1. 建立双层嵌套结构:
    • 动画裁切壳(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)全部放在这一层内部。
  2. 对齐缓动曲线与状态命名:在 原型交互 中配置 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。

  1. AI 聊天栏 / 多行评论输入框:
    • 将文本图层设为 Fill container(宽度随容器换行)+ Hug contents(高度随行数增长)。
    • 外层输入框容器设为垂直/水平 Auto Layout,Height: Hug,并强制添加 Min height = 44px(单行起步高度)与 Max height = 160px(约 5~6 行封顶)。
    • 在超长文本变体中,将外框改为 Fixed = 160px 并开启 Overflow: Vertical scrolling,演示“超出上限后内部出现滚动条而非把整个页面顶爆”。
  2. 单行自适应宽度 <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

五、延伸阅读与站内参考 #

❓ 常见问题与答疑 (FAQ)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。