Figma 原生文本列表、悬挂标点与超链接排印实战:List Spacing 变量绑定、多级缩进规范与前端 HTML/CSS 零偏差交付

2026 年 11 月 20 日

在日常 SaaS 控制台、帮助文档卡片、协议弹窗与详情页设计中,Figma 文本工具 承载了大量信息,但设计师交付时常遇到三类排印失真:条款列表靠手动敲空格加黑点,一旦改行缩进全乱;从 Notion 或 Word 复制带编号的清单粘贴后出现双层序号或行距崩坏;行首引号、列表圆点让左对齐边缘显得参差,文字下划线还会横穿英文 g / y / p 或汉字底横线,导致研发在 Dev Mode 开发模式 里无所适从。

本文将拆解 Figma 原生 文本列表(Bulleted & Numbered Lists)、悬挂标点(Hanging Punctuation & Hanging Lists) 与 超链接下划线精修(Underline Offset) 的工程配置规范,实现画布排印到前端 HTML/CSS 的 1:1 交付。


一、原生文本列表 vs Auto Layout 独立列表组件选型对比 #

在设计界面中的项目符号或编号清单时,应根据业务交互需求选择原生富文本列表还是结构化组件:

评估维度 Figma 原生文本列表(Bulleted / Numbered List) Auto Layout 独立列表组件(Icon/Badge + Text)
适用场景 大段条款协议、富文本文章正文、更新日志、多级嵌套说明文案 功能特性对比(带彩色勾号图标)、步骤条、可交互复选列表
多级缩进与重排能力 极强:键盘 Tab / Shift+Tab 一键升降层级,编号 1.2.3 自动递增重排 较弱:需手动嵌套层级或配置额外缩进变体,增删条目需反复调序
序号/符号样式自由度 固定使用当前字体字形圆点与数字(可调整大小/颜色范围受限) 极高:可替换为任意自定义 SVG 图标、彩色圆底数字徽章或状态标签
前端代码语义映射 在 Dev Mode 与 HTML 交付中天然对应语义化 <ul> / <ol> 与 <li> 映射为 Flexbox 容器列表(display: flex; gap: ...)
维护成本与文件性能 单个 Text 图层即可承载整篇长文,图层树极简、内存开销极低 每多一条列表就多一个子 Frame 与 Icon 实例,长文档会显著拉重画布

选型口诀

“纯文字说明与法律条款用原生 Lists,带彩色图标或交互态的清单用 Auto Layout 组件”。切勿在纯文字协议里为了画个黑点去手敲 • 空格或硬拼上百个 Frame。


二、实操一:多级列表嵌套与 List Spacing 变量精准控距 #

熟练使用原生列表的核心,在于分清 列表项间距(List Spacing) 与 普通段落间距(Paragraph Spacing) 的独立控制权。

1. 快速启用与多级嵌套快捷键 #

  1. 唤起列表模式:选中文本图层进入编辑态,在右侧 Text 面板点击 Type settings(...),将 List style 切换为 Bulleted list(无序圆点) 或 Numbered list(有序编号);也可在空行直接输入 - + 空格或 1. + 空格触发。
  2. 层级升降控制:光标置于列表行按 Tab 向内缩进一级(最多支持 5 级嵌套),按 Shift + Tab 返回上一级;行尾按 Enter 生成同级下一项,连续两次 Enter 退出列表模式;条目内换行不断号请用 Shift + Enter。

2. 分离调控 List Spacing 与 Paragraph Spacing(支持绑定 Variables) #

在右侧 Text 属性面板中,下方有两个独立间距字段(均可直接绑定数值变量,规范参见 Typography Variables 排版变量落地):

  • Paragraph spacing:仅作用于普通非列表段落之间的间距(如设为 12px);
  • List spacing:专门作用于同一列表内部各个 <li> 条目之间的间距(如设为 6px 或 8px)。 将上述字号、行高与间距固化进 Text Styles 文字样式,即可统一全站富文本块的呼吸节奏。

三、实操二:开启悬挂标点(Hanging Punctuation)与悬挂列表光学对齐 #

在高端专题页、数据引语卡片和规范文档中,“物理对齐”往往不等于“视觉对齐”。当左对齐文本框的第一字符是双引号 “、【 或项目符号 • 时,字符左侧自带的空白与标点笔画会让文本块左边界看起来内凹一块。

1. 开启原生悬挂属性 #

  1. 选中目标左对齐文本图层(支持单行或整段),点击右侧 Text 面板的 ...(Type details) 展开高级排印抽屉;
  2. 向下滚动至 Alignment & Hanging(或列表与标点细节区),按场景勾选以下两项:
    • Hanging punctuation(悬挂标点):自动将行首的中文或英文双引号(“ / ")、单引号等起始标点向文本框边界左侧悬挂溢出半个身位,使首行第一个实质汉字或字母与下方正文的左边缘严丝合缝;
    • Hanging lists(悬挂列表):开启后,无序圆点 • 与有序数字 1. 将整体向左突出到文本框外沿,确保所有列表正文的首字符与上方段落标题、正文左边缘处于同一条垂直参考线上。

为什么勾选 Hanging lists / Hanging punctuation 按钮是灰色的?

这两个光学对齐开关仅在文本水平对齐方式为“左对齐(Text align left)”时可用。如果你选中了居中对齐(Center)或右对齐(Right)的文本框,甚至在文本内部混选了不同对齐方式,该开关会自动置灰禁用。此外,请确认容器外层没有开启过窄的 Clip content 裁剪,否则溢出文本框左边界的引号与圆点会被意外切掉一半!建议配合 文本框三态(Auto width / Auto height / Fixed size)规范 检查边界留白。


过去设计师做文字超链接下划线,经常在文字底部手动拉一条 1px 矩形线,一旦响应式换行就彻底错位。现代 Figma 提供了原生下划线参数调控与文字链接能力:

1. 解决下划线“穿过文字”的精修参数 #

  1. 局部选中需要加链接的文字片段,按 ⌘ + U(Mac)或 Ctrl + U(Windows)添加原生下划线(或通过面板点击 Underline 图标)。
  2. 打开 ...(Type details) 面板,找到下划线细节(若当前字体及版本支持下划线扩展调节):
    • 合理设定下划线距离基线的偏移量(与前端 CSS text-underline-offset: 3px 或 4px 对齐),避免线条紧贴汉字底横线或穿过英文字母 g / j / p / q / y 的下延笔画;
    • 对于中文混排正文链接,建议将链接颜色独立绑定语义变量 text/link(而非纯靠黑字加线),并搭配 1px 细线提升可读性(中英文混排细节可参考 Variable Fonts 与中英文混排实战)。

2. 添加原生超链接与 PDF / 原型避坑 #

  • 局部选中文字后,点击顶部或属性栏的 Link 图标(⌘ + K / Ctrl + K),输入目标 URL(可绑定外部文档或站内 Frame 节点)。
  • 关键交互边界提醒:如果你在一个按钮组件内部给文字加了原生超链接,在原型演示时点击该文字会优先触发浏览器打开外部 URL,可能拦截或干扰按钮本身的 On Click 原型跳转!因此组件库内的功能按钮、导航项严禁使用文字原生 Hyperlink,文字链接只应用于纯内容型富文本段落;同时在导出高保真文档时,确保采用矢量文本模式导出 PDF,外部链接才可正常点击跳转(详见 高清 PDF 导出实战)。

五、前端 HTML/CSS 1:1 语义交付对照代码 #

在 Dev Mode 交接富文本与列表规范时,可直接为研发提供以下标准 Tailwind / 原生 CSS 映射契约,彻底消除“设计稿用 List spacing 8px,前端写死 margin-bottom: 16px”的偏差:

/* 1. 对齐 Figma Bulleted / Numbered List 与 List Spacing */
.prose-list {
  margin: 0;
  padding-left: 1.25em; /* 对应 Figma 列表默认缩进宽度 */
}

.prose-list li + li {
  /* 1:1 映射 Figma 的 List spacing 变量 */
  margin-top: var(--spacing-list-item, 8px);
}

.prose-list li::marker {
  /* 保持标记与正文颜色或弱化语义一致 */
  color: var(--text-secondary);
}

/* 2. 对齐 Figma Hanging Punctuation 与超链接下划线偏移 */
.editorial-quote {
  hanging-punctuation: first last; /* Safari 原生支持;通用排版可用负 text-indent 兜底 */
}

.prose-link {
  color: var(--text-link);
  text-decoration-line: underline;
  text-decoration-thickness: 1px;
  text-underline-offset: 4px;      /* 避开字母下延部与汉字底横 */
  text-decoration-skip-ink: auto;  /* 自动避让笔画穿插 */
}

六、文本列表与富文本排印高频报错排查清单 #

在团队日常高频粘贴、跨平台协作与导出交付过程中,若遇到列表乱码或排版崩塌,可对照下表快速处理(更多通用排障请参阅 Figma 常见报错与疑难故障诊断手册):

异常现象 底层原因定位 标准化排查与修复方法
从 Notion / Word / 网页复制列表到 Figma,出现“双重序号”或缩进全丢 富文本剪贴板携带的 HTML <li> 结构与手动前缀符号混杂,Figma 解析时将符号直接当成了普通字符 粘贴时使用纯文本无格式粘贴 ⇧ + ⌥ + ⌘ + V(Mac)或 Ctrl + Shift + V(Windows),再全选使用 Figma 原生列表一键格式化
同一段列表里,圆点(Bullet)或数字突然变得比文字大很多或小很多 列表符号的大小与颜色继承自该行最后一个换行符或首字符的局部样式,混用了字号导致符号失调 全选整段列表文字重新统一应用标准 Text Style,或单独选中整行末端的隐藏换行符同步字号
开启 Hanging lists 后,列表圆点直接消失或被切掉半边 文本框被外层 Frame 包裹且外框宽度恰好贴死文本,同时外层容器勾选了 Clip content 裁剪溢出内容 为父级文本容器设置合理的左内边距(如 Auto Layout padding-left: 16px~24px),或取消非必要的 Clip content 裁剪
给中文段落加下划线后线条紧紧贴住文字底边,看起来像删节线 默认字体的系统下划线偏移值过小,且未使用 Skip ink 或独立 underline-offset 参数 在 Type details 面板微调 Underline offset(一般设为 3px~4px);若所用旧版中文字体渲染下划线位置异常,前端交付时务必补充 CSS text-underline-offset 强制修正
在原型模式预览时,段落里的超链接文字点击没反应或跳转报错 文本链接的 URL 缺少 https:// 协议头、包含未转义的中文空格,或上层存在透明遮罩图层(如 State Layer)挡住了点击穿透 检查链接地址确保以 https:// 开头;核对图层层级面板,确认该文本框上方没有遮挡鼠标事件的透明矩形层

❓ 常见问题与答疑 (FAQ)

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

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