多行列表图标应使用1lh对齐首行
要解决的问题
单行列表常把图标和文字设为 align-items: center。文字换成两行或三行后,图标会移动到整个文本块的中部,离开第一行阅读起点;用户在扫读列表时,图标与对应文本的关联反而变弱。这个规则用首行高度而不是整段高度定位图标。
规则和其他情况说明
- 核心规则:可能换行的图标文本项使用
align-items: flex-start,再以1lh与图标尺寸之差计算顶部偏移,使图标垂直居中于第一行。 - 图标不能收缩:设置
flex-shrink: 0,避免窄容器中图标被文本挤压,导致计算尺寸与实际尺寸不一致。 - 尺寸只定义一次:宽、高与偏移共同引用
--size,修改图标大小后不需要另改一处 margin。 - 首行是阅读锚点:这条规则适用于勾选、状态、类型等标记与首行文字构成同一阅读单元的列表。
- 光学对齐仍需检查:
1lh解决几何位置,不会修正 SVG viewBox 中多余留白或图标视觉重心偏移。
CSS Token
.item {
display: flex;
align-items: flex-start;
gap: 10px;
}
.item svg {
--size: 20px;
flex-shrink: 0;
width: var(--size);
height: var(--size);
margin-block-start: calc((1lh - var(--size)) / 2);
}
- 当
1lh大于图标高度时,上方增加半个行高差,让图标中心落在首行中心。 - 若图标高于一行,偏移可能成为负值,需要重新确定图标尺寸或对齐策略,而不是盲目使用同一公式。
- 容器中的行高应来自真实文字样式;不要同时用另一套固定像素行高造成计算依据不一致。
单行与多行的统一检查
- 单行:图标与文字仍应居中,不应因切换到
flex-start而突然靠上。 - 两行:图标保持第一行位置,不随第二行出现而下移。
- 三行以上:继续以首行为锚点,避免长文本把图标拉到列表项中部。
- 动态内容:字体加载、文字缩放、翻译和容器变窄导致换行时,位置不需要额外 JavaScript 重算。
- 不同图标:勾选、警告、信息图标的内部留白不同,可能需要在图标资产层统一,而不是逐项写 margin。
关键截图与效果

- 来源:作者发布的
1lh列表对齐 CSS 演示。 - 页面或任务场景:Pro plan 特性列表包含 Unlimited projects、Custom domains 等说明,容器宽度变化后出现多行。
- 具体观察:左侧
align-items: center的勾选图标落在多行文本中部;右侧flex-start + 1lh的图标保持第一行高度。两种布局在同一画面对照(E1)。 - 支持的结论:多行项目应以首行为阅读锚点,而不是把整段文字当成单行做垂直居中。
- 证据限制:演示使用固定图标和英文字符,不覆盖所有字体、行高、语言与 SVG 资产。
适用场景
- 定价特性、设置说明、通知、任务列表和带状态图标的文本行。
- 文本会随响应式、翻译或用户字号设置换行的组件。
- 图标表达该行状态或类型,需要与首行建立稳定关联的场景。
不适用场景
- 图标表达整组内容而非首行状态时,可以采用组级居中,但应明确这是另一种语义。
- 多行内容包含独立标题、正文和操作时,可能需要把行拆成内部 grid,而不是只调整一个 SVG margin。
- 图标本身高于首行或带复杂 badge 时,需要重新定义整体行高和热区。
复核清单
- 一行、两行、三行以及容器连续变窄时,图标是否稳定对齐首行。
- 图标是否不收缩,文字放大和字体加载后是否仍正确。
- 不同 SVG viewBox、光学重心和 badge 是否需要资产级修正。
- RTL、书写模式和键盘焦点是否不受额外偏移影响。
来源与证据边界
- 原帖:https://x.com/sanyampunia/status/2113608950814024174
- 视频展示不同容器宽度下的对比;未在真实项目中覆盖所有字体和图标资产,状态保持
draft。