多行列表图标应使用1lh对齐首行

  • 列表
实现
CSS
来源
x.com
收录日期
状态
规约中
多行列表图标应使用1lh对齐首行 规则实证样本

多行列表图标应使用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。

关键截图与效果

Sanyam-首行图标1lh-X源视频帧-20261026.jpg

  • 来源:作者发布的 1lh 列表对齐 CSS 演示。
  • 页面或任务场景:Pro plan 特性列表包含 Unlimited projects、Custom domains 等说明,容器宽度变化后出现多行。
  • 具体观察:左侧 align-items: center 的勾选图标落在多行文本中部;右侧 flex-start + 1lh 的图标保持第一行高度。两种布局在同一画面对照(E1)。
  • 支持的结论:多行项目应以首行为阅读锚点,而不是把整段文字当成单行做垂直居中。
  • 证据限制:演示使用固定图标和英文字符,不覆盖所有字体、行高、语言与 SVG 资产。

适用场景

  • 定价特性、设置说明、通知、任务列表和带状态图标的文本行。
  • 文本会随响应式、翻译或用户字号设置换行的组件。
  • 图标表达该行状态或类型,需要与首行建立稳定关联的场景。

不适用场景

  • 图标表达整组内容而非首行状态时,可以采用组级居中,但应明确这是另一种语义。
  • 多行内容包含独立标题、正文和操作时,可能需要把行拆成内部 grid,而不是只调整一个 SVG margin。
  • 图标本身高于首行或带复杂 badge 时,需要重新定义整体行高和热区。

复核清单

  • 一行、两行、三行以及容器连续变窄时,图标是否稳定对齐首行。
  • 图标是否不收缩,文字放大和字体加载后是否仍正确。
  • 不同 SVG viewBox、光学重心和 badge 是否需要资产级修正。
  • RTL、书写模式和键盘焦点是否不受额外偏移影响。

来源与证据边界