用 CSS field-sizing: content 实现表单控件自适应内容:modern-web-guidance 实战指南
用 CSS field-sizing: content 实现表单控件自适应内容:modern-web-guidance 实战指南
本篇技术指南围绕 modern-web-guidance 仓库中的 form-fields-automatically-fit-contents 用例,讲清如何只靠 CSS 让文本输入框、多行文本域和下拉选择框随内容增长或收缩,不再留下多余空白。读完后你将掌握 field-sizing: content 的完整配置方式、必须同时设置的最小/最大尺寸约束、Flex/Grid 与全局样式造成失效的排查方法,以及可用的降级方案与仓库内的自动化验收方式。
任务来源:三条需求与 daily-grind 基线应用
本用例的开发者提示词保存在 tasks/task.md,全文只有 YAML frontmatter 与三条 - 开头的需求条目:
---
base_app: daily-grind
---
- Add a form with a text input, a textarea, and a select dropdown (with some options) and automatically size them based on their content so they don't have unnecessary whitespace.
- I want my text areas and inputs to automatically grow as users type in them without needing Javascript.
- Update my select dropdowns so they shrink to fit only the currently selected option.
base_app: daily-grind 指明了这段提示词要施加的起始应用,即 src/harness/base-apps/daily-grind/index.html。从仓库结构看,这是一个静态咖啡店首页,只有导航、Hero、卡片网格与页脚,本身并不含表单,因此任务要求是"新增一个包含 input、textarea、select 的表单",而不是改造既有控件。
按 docs/CONTEXT.md 的定义,该用例属于 Gen 1(Legacy root format):根目录下的 grader.ts 搭配 tasks/task.md,评测目标只针对单个基线应用。因此本目录的工件分工如下:
| 文件 | 作用 |
|---|---|
| guide.md | 面向人的技术说明正文,含完整 CSS 与降级方案 |
| demo.html | 可直接运行的正向参考实现 |
| negative-demo.html | 反面示例:固定尺寸、被拉伸的表单 |
| expectations.md | 自然语言断言列表,作为生成评分器的输入 |
| grader.ts | Playwright 评分器,逐条校验期望是否满足 |
| tasks/task.md | 投喂给评测 Agent 的开发者提示词 |
三条需求与实现手段的映射关系可以归纳为:
| 需求 | 技术落点 |
|---|---|
| 三种控件按内容自适应,无多余空白 | 对 input、textarea、select 统一声明 field-sizing: content |
| 输入过程中增长,且不写 JavaScript | 属性本身即声明式能力;JS 只出现在不支持该属性时的降级路径 |
select 收缩到当前选中项 |
select 上的 field-sizing: content + max-inline-size 上限保护 |
默认固定尺寸的成因与 field-sizing 的作用
按 guide.md 的描述,<input>、<textarea>、<select> 默认拥有固定尺寸,无论用户输入或选中多少内容,尺寸都保持不变。field-sizing: content 允许这些控件按内容(包括 placeholder)自动收缩或增长。该属性的另一个取值对应默认的固定尺寸行为,因此这条声明本质上是把"尺寸由内容决定"的计算模式打开。
这一点对 select 的影响尤其直观:未声明时,下拉框宽度由控件自身决定,可能远宽于当前选项;声明 field-sizing: content 后,控件会贴合当前选中项文本,切换选项时随之变化——正好对应任务第二条需求里"shrink to fit only the currently selected option"。
需要注意,field-sizing 并不是一句声明就能收工的属性。guide.md 在 L16 提醒:必须同时考虑继承样式、布局默认行为以及最小/最大约束,否则会出现"空输入框宽度塌成 0、点不到""长 placeholder 导致换行抖动""极长选项撑破页面"等典型问题。
输入框:最小与最大内联尺寸的双向夹逼
guide.md 给出的思路是:文本输入框必须同时设置 min-inline-size(或 min-width)与 max-inline-size(或 max-width)。最小值防止空值时宽度塌陷到 0 而无法点击,最大值防止无限横向增长破坏页面布局。
/* Applies horizontal auto-sizing to inputs */
input {
/* Instructs the element to size itself to fit its content */
field-sizing: content;
/* Reset explicit width if inherited from global styles */
width: auto;
/* Prevents the input from collapsing and disappearing when empty */
min-inline-size: 15ch;
/* Prevents infinite horizontal growth */
max-inline-size: 50ch;
}
逐条解释:
width: auto:把可能从全局样式继承来的显式宽度清掉,让内容尺寸重新成为决定因素。guide.md 在 L67 用 IMPORTANT 强调,显式width/height会覆盖field-sizing: content;若项目全局把input设为width: 100%,必须在使用该属性的元素上重置为width: auto(或width: fit-content)。min-inline-size: 15ch:ch为字符宽度单位,约等于当前字体下数字0的宽度,15ch 保证空输入框仍有可点击的宽度。max-inline-size: 50ch:为横向增长设置硬上限,超出后输入内容在框内横向滚动。- 逻辑属性(
inline-size)与物理属性(width)在此处等价,选择逻辑属性更利于书写模式变化时的表现;评分器对两者都接受,见下文验收章节。
多行文本域:只让垂直方向自动增长
<textarea> 需要区别对待。guide.md 在 L20 说明:如果放任 textarea 横向自适应,会产生明显的体验问题——一个带长 placeholder 的空文本域,在用户输入一个字符后会突然横向收缩。解决办法是给 textarea 显式宽度,让它只在垂直方向随内容换行而增长。
textarea {
/* Instructs the element to size itself to fit its content */
field-sizing: content;
/* Reset explicit height if inherited from global styles */
height: auto;
/* Use a fixed width to prevent jarring horizontal shifts when replacing a long placeholder */
width: 50ch; /* or 100% depending on your layout */
/* Sets a reasonable minimum height (e.g., 3 lines) for empty textareas */
min-block-size: 3lh;
/* Prevents infinite vertical growth. Once a textarea hits this */
/* height, it will stop growing and show a vertical scrollbar. */
max-block-size: 10lh;
}
这里的三个尺寸约束各有职责:
height: auto是自动增长的前提。若全局样式给 textarea 设了固定height(例如height: 100px),必须显式重置,否则field-sizing不生效。width: 50ch(或100%)锁定水平尺寸。宽度固定后,内容只能在垂直方向堆叠,增长行为因此可预测。min-block-size: 3lh与max-block-size: 10lh划定高度区间。lh是行高单位,3lh约等于三行文本的高度,既保证空态可点击可聚焦,也避免内容极多时把页面顶开——到达上限后控件停止增长并出现垂直滚动条。
参考实现里还加了一条容易被忽视的声明,见 demo.html:
textarea {
height: auto;
width: 50ch; /* Using a fixed char width instead of 100% for the demo */
box-sizing: border-box; /* Ensure padding doesn't cause overflow */
min-block-size: 3lh;
max-block-size: 10lh;
}
box-sizing: border-box 让 padding 与边框计入宽度,避免"宽度 50ch + 左右 padding"把控件撑出容器。当 demo 使用固定字符宽度而非 100% 时,这一点尤其重要。
下拉选择框:收缩到当前选项并保留上限
select 的配置最精简,但也必须有上限保护:
select {
/* Sizes the select element to fit the active option only */
field-sizing: content;
/* Prevents the dropdown from expanding infinitely and breaking the layout */
max-inline-size: 50ch;
}
guide.md 在 L22 指出,给使用 field-sizing: content 的 <select> 设置 max-inline-size 是推荐做法,目的是防止某个超长选项文本把页面布局撑坏。参考实现中 select 还会补上 width: auto 与 align-self: start,原因见下一节。
三个会让方案失效的布局干扰
guide.md 用两段 IMPORTANT 归纳了最容易踩的坑,参考实现与反面示例则可作为对照证据。
1. 全局 width/height 覆盖
显式尺寸优先级高于 field-sizing: content。因此重置是必需步骤:input、select 重置 width: auto,textarea 重置 height: auto 并给出明确宽度。这是"属性写了却没效果"的第一排查点。
2. Flex/Grid 的隐式拉伸
guide.md 在 L69 说明:Grid 与 Flexbox 常会把子项拉伸以填满可用空间。如果某个使用 field-sizing: content 的控件"怎么都不肯缩小",就要检查容器的对齐属性,并在控件上应用 align-self: start 或 justify-self: start 覆盖拉伸。
demo.html 正是这么写的:外层 form 是纵向 flex 容器,label 也是 flex 容器并设置 align-items: flex-start,同时 input 与 select 各自带 align-self: start,双重保证控件不会被拉满一行。
3. 反面示例揭示的三个症状
negative-demo.html 刻意保留了传统写法:
label {
align-items: stretch;
}
input[type="text"] {
width: 100%;
align-self: stretch;
}
select {
width: 100%;
align-self: stretch;
}
textarea {
height: 100px;
}
它同时包含了三类反模式:width: 100% 的显式宽度覆盖、align-self: stretch 的布局拉伸、height: 100px 的固定高度。三者任一存在,field-sizing: content 都会失效。这三个症状恰好对应 guide.md 中两条 IMPORTANT 的成因,可以把它当作"迁移前快照"来对比。
完整参考实现
把上述片段拼起来,就是 demo 中可运行的完整版本(demo.html 的样式部分):
input[type="text"],
textarea,
select {
font-family: inherit;
font-size: 1rem;
padding: 0.5rem;
border: 1px solid #999;
border-radius: 4px;
/* Apply auto-sizing to all fields */
field-sizing: content;
}
input[type="text"] {
width: auto; /* Reset explicit width if inherited */
align-self: start; /* Override flex/grid stretching */
min-inline-size: 15ch; /* Prevent collapse when empty */
max-inline-size: 50ch; /* Prevent excessive growth */
}
select {
width: auto;
align-self: start;
max-inline-size: 50ch;
}
textarea {
height: auto; /* Reset explicit height if inherited */
width: 50ch; /* Stable horizontal width */
box-sizing: border-box;
min-block-size: 3lh;
max-block-size: 10lh;
}
配套结构里,三个控件各自包在 label 内,textarea 外层多一个 div.growable-textarea,其 data-replicated-value 属性既服务于降级方案,也作为镜像文本的载体:
<form>
<label>
Name (Input):
<input type="text" placeholder="Your full name">
</label>
<label>
Message (Textarea):
<div class="growable-textarea" data-replicated-value="">
<textarea placeholder="Write a long message here. It will wrap and grow vertically once it hits the max width."></textarea>
</div>
</label>
<label>
Favorite Color (Select):
<select>
<option value="red">Red</option>
<option value="blue">Blue</option>
<option value="super-long-color">A ridiculously long color name just to test sizing</option>
</select>
</label>
</form>
最后一个超长选项是刻意设计的:它用来验证 max-inline-size: 50ch 是否真的阻挡了"选中项撑破布局"。
渐进增强与降级方案
guide.md 在 L71-L77 明确将该能力定位为渐进增强,并用 {{ BASELINE_STATUS("field-sizing") }} 宏引用 Baseline 状态(宏的展开机制见后文)。不支持该属性的浏览器会退回到默认固定尺寸:用户在固定尺寸的输入框、文本域内滚动查看溢出内容,功能可用、体验降级。
只有当动态增长对体验至关重要时,才值得引入降级方案。guide.md 给出的最稳做法是用 CSS Grid 让一个隐藏伪元素实时镜像用户输入,从而撑高 grid 容器,容器内的 textarea 随之变高:
<!-- The textarea is wrapped in a container that will mirror its value -->
<div class="growable-textarea" data-replicated-value="">
<textarea></textarea>
</div>
// Only attach the fallback event listeners if field-sizing is unsupported
if (!CSS.supports('field-sizing', 'content')) {
document.querySelectorAll('.growable-textarea > textarea').forEach(textarea => {
textarea.addEventListener('input', () => {
textarea.parentNode.dataset.replicatedValue = textarea.value;
});
});
}
/* Only apply the fallback if field-sizing is NOT supported */
@supports not (field-sizing: content) {
.growable-textarea {
display: grid;
}
/* The pseudo-element and textarea must share the exact same cell, font, and padding */
.growable-textarea::after,
.growable-textarea > textarea {
grid-area: 1 / 1 / 2 / 2;
font: inherit;
padding: 0.5rem;
border: 1px solid #999;
}
/* The pseudo-element renders the copied text invisibly to stretch the grid */
.growable-textarea::after {
/* The space is necessary for trailing empty lines to be rendered */
content: attr(data-replicated-value) " ";
white-space: pre-wrap;
visibility: hidden;
}
.growable-textarea > textarea {
resize: none;
overflow: hidden;
}
}
这套方案有三个必须对齐的同步点,任何一处不匹配都会造成高度偏差:
- 同一网格单元:伪元素与 textarea 都使用
grid-area: 1 / 1 / 2 / 2,占据完全相同的格子,镜像文本的长宽才能直接换算成 textarea 的长宽。 - 样式完全一致:
font: inherit、相同的padding与border必须同时作用于两者,否则文字换行位置不同,镜像高度就失真。 - 空白与换行:
content: attr(data-replicated-value) " "末尾的空格是必要的,用于让结尾的空行也被渲染;white-space: pre-wrap保证换行与连续空白按输入原样保留。同时resize: none与overflow: hidden阻止用户手动改变尺寸、出现内部滚动条。
条件判断是双向的:JS 侧用 if (!CSS.supports('field-sizing', 'content')) 才注册事件监听,CSS 侧用 @supports not (field-sizing: content) 才应用镜像样式,避免在现代浏览器上做无谓的 DOM 写入。demo 中的脚本见 demo.html。
guide.md 在结尾给出了务实结论:为每种控件复制样式、跨 DOM 节点同步状态的成本很高,除非动态尺寸对体验至关重要,否则推荐直接接受固定尺寸的默认回退行为。这与任务需求中"不要 JavaScript"的取向一致——JS 只应出现在兼容旧浏览器的补丁路径里。
降级方案的边界
上述镜像技巧只解决 textarea 的垂直增长。input 与 select 在旧浏览器上没有等价的纯 CSS 替代,需要额外的测量脚本或第三方库(例如 autosize)。仓库的静态分析规则正是把这类命令式方案标注为"应迁移到 field-sizing: content",见下一节。
验收:expectations.md 与 grader.ts 的逐条对应
expectations.md 用自然语言列出 10 条可观察断言,grader.ts 把它们翻译成 Playwright 测试。二者的对应关系如下:
| 期望(expectations.md) | 评分器断言(grader.ts) |
|---|---|
输入框应用 field-sizing: content |
styles['field-sizing'] === 'content' |
| 输入框有最小内联尺寸 | 存在 min-inline-size 或 min-width |
| 输入框有最大内联尺寸 | 存在 max-inline-size 或 max-width |
文本域应用 field-sizing: content |
styles['field-sizing'] === 'content' |
文本域显式 height 为 auto 或 fit-content |
['auto', 'fit-content'].includes(styles['height']) |
| 文本域有显式内联尺寸 | 存在 width 或 inline-size |
| 文本域有最小块尺寸 | 存在 min-block-size 或 min-height |
| 文本域有最大块尺寸 | 存在 max-block-size 或 max-height |
select 应用 field-sizing: content |
styles['field-sizing'] === 'content' |
select 有最大内联尺寸 |
存在 max-inline-size 或 max-width |
评分器的取值方式值得注意(grader.ts):它遍历 document.styleSheets 中的所有 CSSStyleRule,用 el.matches(rule.selectorText) 判断规则是否命中目标元素,把命中的声明收集进一个对象,随后再叠加元素的行内样式。这意味着:
- 评分看的是声明是否存在,而不是运行时测量出的像素宽度,因此不依赖具体渲染环境;
- 声明写在外部样式表、
<style>块或style属性中都能被识别; - 逻辑属性与物理属性被同等接受(
min-inline-size与min-width二选一即可),给实现留出了书写习惯上的自由度。
测试前置钩子用 page.route('http://localhost/*') 把请求映射到 TARGET_FILE 所在目录的本地文件(grader.ts),因此评分器不依赖外部服务器,只需指定待测 HTML 文件。该约定与评分运行器一致:run-grader.ts 在启动 Playwright 前把目标路径写入 TARGET_FILE 环境变量。
反过来,negative-demo.html 一条期望都无法满足:它没有 field-sizing 声明,input/select 只有 width: 100%,textarea 只有固定 height: 100px,缺少最小/最大尺寸。这为评分器提供了"零通过率"的对照基线。
仓库中的自动化迁移检测
除了文档与评分器,仓库还在静态分析层内置了这条指南对应的规则,用于在真实代码库里发现"应该迁移但尚未迁移"的写法:src/analyzing/rules/form-fields-automatically-fit-contents.ts。
规则通过 fastTokens(autosize、scrollHeight、scrollWidth)做快速预筛(L234-L240),命中两类模式:
- 库调用:
autosize(textarea)这类直接调用,或$(...)、含textarea/input/field字样的接收者上的.autosize()方法(L65-L86)。命中的提示语为应改用 CSSfield-sizing: content。 - 命令式测量:形如
style.height = 'auto'后紧跟style.height = el.scrollHeight + 'px'的赋值链(L88-L134)。规则会向上查找是否处于input/keyup/keydown/change/text事件回调,或处于名称含textarea/autogrow/autosize/field等关键字的辅助函数中,并排除dialog/canvas/virtual/scrollbar等非表单容器。
规则的 verifierRubric 说明了保留与放行的判定标准(L274-L286):
| 类别 | 条件 |
|---|---|
keepWhen |
keyup/input/change/keydown 监听器用 scrollHeight/scrollWidth 重算表单高度;辅助函数先把 .style.height 重置为 auto/0px/1px 再按 scrollHeight 设置;调用了 autosize() 库 |
dropWhen |
代码已被 CSS.supports("field-sizing", "content") 之类的特性检测保护;scrollHeight 用于滚动条滑块、虚拟滚动窗口或文档滚动进度;被调整的是 canvas、iframe、弹窗容器而非表单控件 |
测试用例给出了具体证据(form-fields-automatically-fit-contents.test.ts):正向用例覆盖 ESM 引入的 autosize、React componentDidMount 中的 ref 调用、经典 input 监听器、jQuery 风格 input.on('keyup text', ...) 以及 autoExpandTextarea 辅助函数;反向用例则验证特性检测保护下的代码、弹窗溢出检测、窗口滚动进度计算、orientationchange 监听器以及 chart.autosize() / grid.autosize() 都不会被误报。
对本文主题而言,这条规则的实践意义是:它把 guide.md 中的最佳实践变成了可执行的检查项——凡是仍用 JS 测量 scrollHeight 来撑高输入框的代码,都应改写为 field-sizing: content;而已经用 CSS.supports 做了特性检测的降级分支属于合规写法,不应被清理。
Baseline 状态宏与文档构建约束
guide.md 并未硬编码"该特性在哪些浏览器可用"这类结论,而是在 L73 放置了宏 {{ BASELINE_STATUS("field-sizing") }}。这个宏在构建时由 src/core/macros.ts 的 BASELINE_STATUS 处理器展开:它调用 getStatusMessage(featureId, bcdKey) 取状态,找不到时直接抛出 MacroError,避免文档里出现无依据的兼容性描述。展开逻辑本身位于 src/core/baseline.ts,其状态来源是 web-features 与 @mdn/browser-compat-data 两个数据包。
同时,src/core/guide-validation.ts 会检查正文中是否出现硬编码的 Baseline 可用性断言,若发现则提示改用 {{ BASELINE_STATUS("feature-id") }} 宏。因此在仓库内撰写或扩展本主题的文档时,正确做法是引用宏而不是手写版本与日期。
这也解释了为什么本文只描述"支持与不支持两种行为",而不给出具体浏览器版本与日期:这类会随时间变化的事实应当交给构建期的数据源,而不是固化在文章里。
落地检查清单
将方案应用到实际项目时,按以下顺序自查可以覆盖绝大多数失败场景:
- 三种控件都声明了
field-sizing: content,且选择器真正命中目标元素(注意type限定,评分器会排除input[type="submit"]与input[type="button"])。 input重置width: auto,并同时具备最小与最大内联尺寸(推荐min-inline-size: 15ch、max-inline-size: 50ch起步)。textarea重置height: auto,设定明确宽度(50ch或100%),并给出min-block-size/max-block-size区间;使用固定字符宽度时补box-sizing: border-box。select具备max-inline-size,避免超长选项撑破布局。- 检查容器对齐:Flex/Grid 子项被拉伸时,用
align-self: start或justify-self: start解除。 - 确认没有更高优先级的显式尺寸:全局样式表、组件库、内联样式中的
width/height都要排查。 - 降级路径加特性检测:JS 用
CSS.supports('field-sizing', 'content')取反判断,CSS 用@supports not (...),两处条件保持一致。 - 验证方式:直接打开 demo.html 观察空态、输入中、超长内容三个状态;或按仓库约定以
TARGET_FILE指向待测文件运行 grader.ts 做声明层面的回归校验。
适用边界与取舍
- 渐进增强优先:
field-sizing的价值在于用一行声明替掉一整段测量脚本;不支持时退回固定尺寸与内部滚动,功能不丢失。 - 不要对 textarea 开启横向自适应:长 placeholder 会在首次输入时造成宽度突变,显式宽度是必要的抑制手段。
- 上限不是可选项:
input与select缺max-inline-size、textarea缺max-block-size,都会让"自适应"在极端内容下变成"布局失控"。 - 降级成本要算清:镜像方案需要伪元素与 textarea 在网格单元、字体、内边距、边框上完全一致,还要在每次输入时同步
data-*;guide.md 因此建议,除非动态尺寸是体验关键,否则接受默认定尺寸回退更划算。 - 迁移判断可自动化:仓库的静态分析规则已能识别
autosize()与scrollHeight撑高模式,并跳过受特性检测保护的代码,适合在代码库中批量排查待迁移点。