Figma A4 报表发票设计与现代 CSS @media print / CSS Paged Media 及 Puppeteer PDF 工程化交付实战:跨页防截断、毫米物理换算与页眉页脚重复指南

2026 年 11 月 21 日

在企业级 ERP、财务 SaaS、跨境物流面单、电子合同签约以及 BI 数据报告系统中,设计师经常需要在 Figma 中绘制大量 A4 纸张规格(210 × 297 mm) 的单据与文档模板。许多团队以为按 Figma 预设的 A4 (595 × 842 px) 画完再交给 Dev Mode(开发模式) 就大功告成了,结果前端工程师通过浏览器 window.print() 或后端无头浏览器(Puppeteer / Playwright)渲染导出 PDF 时,却频频爆发四类“惨烈事故”:

  1. 表格行与签名栏被生生劈成两半:第 1 页末尾半行文字,第 2 页开头露出半个签名章,跨页衔接处毫无防截断保护;
  2. 表头深色底纹、状态徽标颜色全部消失:网页端看得好好的蓝色表头与浅灰斑马纹,一进打印预览或生成 PDF 就变成了惨白一片;
  3. 尺寸整体偏大或右侧被无情裁切:Figma 里的 595 px 宽度直接照抄到网页 CSS 里写成 width: 595px,但在浏览器打印管线(96 dpi)下,A4 纸的实际可用宽度高达 794 px,导致比例完全错乱;
  4. 多页明细表第二页起丢失表头与页码:长达 5 页的采购清单从第 2 页开始只剩光秃秃的数据行,且每页底部缺少“第 X 页 / 共 Y 页”与固定企业页脚。

要彻底打通“Figma 屏幕设计稿 → 网页打印 / 无头浏览器 PDF 导出”的最后一公里,必须精确对齐 72 dpi / 96 dpi 物理尺寸换算、CSS Paged Media(@page) 与 打印分块防断流规范。


一、Figma 72 dpi 像素与 CSS 打印物理单位(96 dpi / mm / pt)换算矩阵 #

Figma 内置纸张预设(Paper Presets)默认基于传统印刷排版基准 72 PPI(即 1 px = 1 pt) 建立画板;而现代浏览器 CSS 引擎固定采用 96 DPI(即 1 inch = 96 px,1 pt = 1.333 px)。如果在 Dev Mode 中直接照抄 px 数值而不区分屏幕与纸张单位,就会导致严重的缩放偏差。

纸张规格 / 度量维度 物理实际尺寸(mm) Figma 预设画板(72 dpi 基准) 现代 CSS 打印像素(96 dpi 等效) CSS 打印样式表推荐写法
A4 纵向(Portrait) 210 × 297 mm 595 × 842 px 793.7 × 1122.5 px @page { size: A4 portrait; }
A4 横向(Landscape) 297 × 210 mm 842 × 595 px 1122.5 × 793.7 px @page { size: A4 landscape; }
US Letter(北美信纸) 215.9 × 279.4 mm 612 × 792 px 816 × 1056 px @page { size: letter portrait; }
标准安全页边距(Margin) 上下 15 mm / 左右 15 mm 约 42 px(建议取 40 或 44 px) 约 56.7 px @page { margin: 15mm 15mm; }
正文排版字号(Print Font) 印刷级 10 pt ~ 11 pt Figma 中设为 10 ~ 11 px(即 pt) 13.33 ~ 14.67 px 打印样式表中统一使用 pt 单位(如 font-size: 10pt;)
细分割线描边(Hairline) 0.5 pt ~ 0.75 pt 0.5 px ~ 1 px(浅灰 #E5E7EB) 0.67 px ~ 1 px border-bottom: 0.5pt solid #CBD5E1;

关键认知校准:如果设计师只是从 Figma 直接导出单页静态宣传单去印刷厂打印,请遵循 高清 PDF 导出与印刷印前交付实战(重点关注 3mm 出血位与 CMYK);如果是交给开发动态生成多页数据报表、发票或合同,务必在设计规范中明确要求开发在 @media print 中用 mm 定义纸张与边距、用 pt 定义字号与细线,而不是把 Figma 的 595px 画板硬编码为网页宽度。


二、实操一:在 Figma 中建立面向多页动态数据的 A4 模板架构 #

动态渲染的发票与报表行数不固定(可能是 3 行,也可能是 180 行)。设计师在 Figma 中搭建母版时,切忌画一个“死板固定高度的静态大画板”,而应采用流式单据模块化架构:

1. 遵循“固定页眉 + 弹性流水表格 + 独立不可拆分尾部”三段分层 #

  1. 外层画板设定:新建 595 × 842 px(标注等效 A4: 210 × 297 mm)画板作为第一页基准视口参考,内部设置上下左右 42 px(对应 15 mm)安全内边距;在大型复杂系统下参考 设备与画板尺寸速查表 做好规范归档;
  2. 第一页抬头区(Header Block):放置企业 Logo(优先矢量 SVG 或 ≥300 DPI 的 @3x PNG)、单据编号、二维码及开票方/收票方双栏信息,使用水平 Auto Layout + Space between 保持左右对称;
  3. 动态明细分录表(Flow Table):参考 复杂数据表格系统架构实战 拆分为独立 Table_Header(表头组件)与 Table_Row(单行条目组件)。并在 Dev Mode 原生开发标注 中为表头标明 Repeat on every page (thead),为单行标明 No page split inside (break-inside: avoid);
  4. 不可拆分的结算与签章区块(Atomic Summary & Signature):将“合计金额大写、税率明细、公章与财务签名栏”打包为一个独立的 Auto Layout Frame(Footer_Summary_Block),并在 Dev Mode 中标注 Keep together as atomic block——强制要求如果当前页底部剩余空间不足,整个签章区块必须整体顺延至下一页顶部,绝不能把“合计”留在上一页而把“盖章处”挤到下一页。

2. 打印色彩与字体安全性检查 #

  • 高对比度黑白打印兜底:很多企业客户或财务部门使用黑白激光打印机出单。浅灰文字 #94A3B8 在黑白碳粉打印下极易模糊不清,建议打印模板正文统一采用纯黑或极深灰(#111827),辅助文字不浅于 #4B5563;
  • 字体嵌入风险排查:若使用思源黑体(Noto Sans SC)或苹方等字体,需在交付清单中向前端注明服务端生成 PDF 容器必须预装对应字体包或引入 @font-face 子集,避免无头浏览器在 Linux Docker 环境里因缺字回退为方框乱码(字形与行高对齐细节见 字体渲染与盒模型零偏差对齐实战,字体排查见 字体工作指南)。

三、实操二:Dev Mode 交付现代 CSS @media print 与 @page 工程模板 #

为了让网页预览与导出 PDF 的还原度达到 100%,前端团队可以直接复用以下现代 CSS 打印标准模板,对应解决背景色丢失、分页撕裂、表头重复与强制分页问题:

/* 1. 声明物理纸张规格与页边距(替代死板的 595px 硬编码) */
@page {
  size: A4 portrait;
  margin: 15mm 15mm 18mm 15mm;

  /* 现代 CSS Paged Media 页眉页脚边距盒(Chromium 131+ / Safari / WeasyPrint 已支持) */
  @bottom-right {
    content: "第 " counter(page) " 页 / 共 " counter(pages) " 页";
    font-size: 8.5pt;
    color: #4b5563;
  }
}

/* 首页可单独取消顶部冗余页眉,保持发票抬头整洁 */
@page :first {
  margin-top: 12mm;
}

@media print {
  /* 2. 强制保留 Figma 中的表头底色、标签背景色与高亮色块 */
  * {
    -webkit-print-color-adjust: exact !important;
    print-color-adjust: exact !important;
  }

  /* 隐藏网页导航栏、打印按钮、侧边栏等非单据 UI */
  .no-print,
  .app-sidebar,
  .toolbar-actions {
    display: none !important;
  }

  body {
    margin: 0;
    padding: 0;
    font-size: 10pt;
    line-height: 1.45;
    color: #111827;
    background: #ffffff;
  }

  /* 3. 原生表格跨页自动重复表头(thead)与表尾 */
  table.invoice-table {
    width: 100%;
    border-collapse: collapse;
  }

  table.invoice-table thead {
    display: table-header-group; /* 核心:每一页自动重复渲染表头 */
  }

  /* 4. 严禁单个明细行、汇总卡片、签名章区块在中间被分页符劈开 */
  table.invoice-table tr,
  .footer-summary-block,
  .signature-box {
    break-inside: avoid;
    page-break-inside: avoid;
  }

  /* 5. 章节大模块(如合同附件页)强制另起一页 */
  .appendix-section {
    break-before: page;
    page-break-before: always;
  }
}

服务端 Puppeteer / Playwright 导出 PDF 黄金参数 #

当业务需要由 Node.js 后端直接静默生成可下载 PDF 附件(而非让用户在浏览器弹窗手点打印)时,开发在调用 page.pdf() 时务必传入以下两项核心参数与 Figma 模板对齐:

await page.pdf({
  format: 'A4',
  printBackground: true,      // 必须为 true,否则 Figma 表头和状态 Tag 的背景色全白丢失
  preferCSSPageSize: true,    // 优先读取 CSS @page 中声明的 size 与 margin,避免双倍留白
  displayHeaderFooter: true,  // 若需兼容旧版页码方案,可开启并使用 headerTemplate / footerTemplate
  margin: { top: '0mm', right: '0mm', bottom: '0mm', left: '0mm' } // 交由 CSS @page 统一控制边距
});

四、Figma 打印与 PDF 工程化交付排障速查表 #

线上打印 / 导出 PDF 异常现象 底层根因定位 Figma 与前端协同修复方案
Figma 里的灰色表头、蓝色高亮胶囊在 PDF 里全部变成了白底 浏览器默认开启省墨模式(忽略背景色与背景图),且后端 printBackground 未开启 CSS 全局注入 print-color-adjust: exact, 服务端 Puppeteer 显式配置 printBackground: true
长表格跨页时,某一行的上半部分留在第 1 页,下半部分掉到第 2 页 前端用 <div> + Flex/Grid 模拟表格,或未对 <tr> 设置防打断规则 明细表坚持使用原生 <table> + <thead> + <tbody>,对 tr 与卡片容器声明 break-inside: avoid
第 2 页以后的表格失去了表头,只能看到密密麻麻的数字 未使用原生 <thead> 包裹表头,或将 display: table-header-group 覆盖为了 flex 确保表头放在 <thead> 标签内且保持默认表格布局,切勿对 thead 强行施加 display: flex
在 Mac 上导出 PDF 字体锐利对齐,部署到 Linux 服务器后变成宋体且折行溢出了 服务端容器缺少设计稿使用的字体文件(如 PingFang / Inter),触发系统字库降级 打包前将 WOFF2 / TTF 字体内联进 CSS @font-face 或安装至容器 /usr/share/fonts;详见 字体安装与排查指南
页面边缘多出浏览器自带的网址 URL、时间戳和默认页眉 未在 @page 中重置 margin,浏览器自动在默认页边距区绘制了页眉页脚 在 @page 中明确指定 margin: 15mm(若完全不需要默认 URL 可设 margin: 0 并在容器内加 padding)
矢量图标或公司公章导出 PDF 后发虚有锯齿 设计师导出成了 @1x PNG 位图,或前端用 CSS box-shadow / filter 触发了栅格化 公章、Logo、条形码优先以纯净矢量 SVG 交付(详见 导出设置入门),避免大面积半透明模糊特效

掌握 Figma 72 dpi 预设与 CSS 96 dpi 毫米/磅值(mm/pt)的换算体系,并在设计阶段就把动态单据拆分为“可重复表头 + 不可拆分行 + 原子化签章尾块”,开发只需套用标准化的 @media print 与 @page 工程模板,即可彻底告别“页面好看、打印崩溃”的交付顽疾;如需核对更多画板基准或异常排障,可随时查阅 设备与画板尺寸速查表 与 常见报错与疑难故障诊断手册。

❓ 常见问题与答疑 (FAQ)

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

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