JS 打印内容整体缩小:zoom 与缩放比例排查

先给结论:出纸缩成 70%,先查这三处

打印预览里排版正常,一点打印,A4 出纸内容整体缩了一圈,量一下边距,左右各多出三厘米。这种"预览对、出纸错"的情况,八成不是打印机的问题,而是打印链路里被二次缩放了一次。我们维护的 vue-print-designer(https://gitee.com/theGreatOldFive/vue-print-designer)在 issue 里被问过很多次,最后定位到的原因基本都落在下面三处。

先查这三处,按命中率排序:

  1. 打印根节点的 zoom / transform: scale() 。屏幕端为了适配窄屏做整体缩放,样式写在 .print-root 或某个祖先容器上,打印时没摘掉,直接跟着进了打印文档。
  2. 浏览器打印对话框里的缩放比例。Chrome 默认"适合页面",某些版本会记住上次手选的 80%、70%,换台机器就不一样,排查时容易被忽略。
  3. @page 纸张尺寸与单位换算 。size: A4 没写,或者写了 size: 210mm 297mm 但容器宽度用了 px 又叠加了缩放,实际内容宽度就和纸张对不上。

快速止血 :打印前把打印根节点的 zoom 重置为 1、transform 设为 none,@page 固定纸张尺寸,打印对话框缩放手动保持 100%。下面这版最小重置样式可以直接复制进项目,能排掉大部分 70% 缩放:

css 复制代码
@media print {
  /* 摘掉屏幕端的整体缩放,别让它跟着进打印文档 */
  .print-root,
  .print-root .zoom-wrapper {
    zoom: 1 !important;
    transform: none !important;
    width: 210mm !important;
    margin: 0 !important;
  }

  @page {
    size: A4 portrait;
    margin: 10mm;
  }

  html, body {
    width: 210mm;
    margin: 0;
    padding: 0;
    -webkit-print-color-adjust: exact;
    print-color-adjust: exact;
  }
}

注意 zoom: 1 !important 要打在真正带缩放的那一层。有人把 zoom: 0.7 写在 .app-main 上,只重置 .print-root 是没用的,得顺着 DOM 往上找到第一个非 1 的 zoom 或非 none 的 transform。用 DevTools 的 Computed 面板逐个祖先节点看,比猜快。

数据说话 :A4 纸宽 210mm。容器上挂 zoom: 0.7,内容实际渲染宽度就是 210 × 0.7 = 147mm,右边空出 63mm,肉眼就是"整体缩一圈、字变小、留白变大"。如果是 transform: scale(0.7),因为 transform 不改变布局盒尺寸,表现会更怪------内容按 210mm 排版、按 147mm 绘制,右边被裁或错位,这时候光看宽度数字对不上,得看 getBoundingClientRect() 的实际值。

三处都排完还是缩,再去看是不是打印服务端(比如 PDF 生成中间件)自己带了缩放参数。那属于另一条线,后面单独说。

现象判定:预览正常、出纸缩小,问题在输出层

预览正常、出纸缩小,这个组合基本可以把问题锁死在输出层。预览走的是浏览器渲染管线,DOM 怎么排、分页怎么切,预览里都对得上,说明布局和分页逻辑没毛病;出纸缩小,说明内容在送往打印机或 PDF 生成器的路上被整体缩了一道。两者同时成立,排查方向就两条:DOM 线看祖先链上的 zoom、transform: scale、写死的 width;输出线看打印缩放比例、@page size、系统 DPI 缩放。

先给判定方法,省得来回猜。在打印预览里挑一个已知尺寸的元素,比如一个 width: 100mm 的块,用 DevTools 量它在屏幕上的像素宽度,再除以当前缩放下的毫米换算比。如果量出来稳定偏 0.7,那就是缩放,不是字体变小、也不是边距吃掉了内容------字体和边距造成的偏差不会这么整齐。0.7 这个数很常见,因为屏幕适配里 zoom: 0.7 或 transform: scale(0.7) 是高频写法。

DOM 线的查法:从目标元素往上走祖先链,在 Computed 面板逐个看 zoom 和 transform。zoom 会改变布局盒尺寸,transform: scale 不改变布局盒、只改绘制,两者表现不同。容器挂 zoom: 0.7,210mm 宽的内容实际渲染成 147mm,右边空出 63mm,肉眼就是整体缩一圈、留白变大;挂 transform: scale(0.7) 则是按 210mm 排版、按 147mm 绘制,右边被裁或错位,光看宽度数字对不上,得看 getBoundingClientRect() 的实际值。重置时 zoom: 1 !important 要打在真正带缩放的那一层,写在 .app-main 上的 zoom: 0.7,只重置内层容器是没用的。

输出线先看打印对话框里的缩放比例是不是 100%,再看 @page 的 size 有没有和实际纸型对上,最后看系统显示缩放------Windows 的 125%、150% 有时会带进打印链路。用 它 这类方案时,打印样式里显式写死 @page { size: A4 portrait; margin: 10mm; } 能挡掉一部分纸型推断带来的偏差。

吐槽一句:很多"打印 bug"其实是屏幕适配代码带进了打印样式。开发时为了小屏好看给容器加了 zoom: 0.7,打印样式没清干净,预览里因为视口宽度不同看着挺对,一出纸就露馅。

根因一:容器 zoom / transform 被打印继承

最常见的写法是这样:屏幕端为了适配小屏,给主容器加一句 zoom: 0.7,或者用 transform: scale(0.7) 把整块界面缩下来。屏幕上看没问题,打印时这段样式没有清掉,容器里的表格、文字、页边距就全部跟着缩了。0.7 这个比例正好对应你量出来的 70%,所以先查祖先链上的缩放,比查字体和边距更快。

zoom 和 transform: scale 在打印里的表现不一样,排查时得分开看。zoom: 0.7 会改变布局盒尺寸,210mm 宽的内容实际按 147mm 参与排版,右边空出 63mm;transform: scale(0.7) 不改变布局盒,按 210mm 排版、按 147mm 绘制,getBoundingClientRect() 拿到的是缩放后的值,offsetWidth 还是原值。两个数字对不上时,基本就能确定是 transform 而不是 zoom。

排查别只盯当前元素,要沿祖先链往上走,并且要在打印媒体下再查一遍------屏幕样式和打印样式是两套,屏幕上 zoom: 1 不代表打印时也是 1。下面这段脚本把祖先链上的 zoom、transform、width 一起打出来,在打印预览的 iframe 里执行一次,或者在 beforeprint 事件里跑:

js 复制代码
function traceScale(el) {
  const chain = [];
  let node = el;
  while (node && node !== document.documentElement) {
    const cs = getComputedStyle(node);
    if (cs.zoom !== '1' || cs.transform !== 'none') {
      chain.push({
        el: node.tagName + (node.id ? '#' + node.id : '') +
            (node.className ? '.' + String(node.className).split(' ')[0] : ''),
        zoom: cs.zoom,
        transform: cs.transform,
        width: node.getBoundingClientRect().width
      });
    }
    node = node.parentElement;
  }
  console.table(chain);
  return chain;
}
// 打印前跑一次,确认打印媒体下没有残留缩放
window.addEventListener('beforeprint', () => traceScale(document.querySelector('.print-root')));

修复的原则是:打印媒体下强制把缩放归位,并且把重置打在真正带缩放的那一层。只重置内层容器没用,.app-main 上的 zoom: 0.7 还在,子元素照样继承。

css 复制代码
@media print {
  html, body { zoom: 1 !important; }
  .app-main, .screen-scale-wrap {
    zoom: 1 !important;
    transform: none !important;
  }
  /* 打印容器不复用屏幕缩放容器,单独挂在 body 下 */
  .print-root {
    zoom: 1 !important;
    transform: none !important;
    width: 210mm;
    margin: 0 auto;
  }
}
@page { size: A4 portrait; margin: 10mm; }

更彻底的做法是打印时不要复用屏幕容器。屏幕容器上挂着 zoom、transform、overflow: hidden,这些在打印里全是干扰项。把要打印的节点克隆到一个独立的打印容器里,或者塞进 iframe,重置样式只作用于这个容器,屏幕样式再怎么改也带不进去。该方案 走的就是这条路:打印时克隆到独立容器,默认把 zoom 和 transform 归位,模板按 mm 设计,纸张适配靠 @page 和分页,不靠 transform 缩。设计器里 210mm 就是 210mm,出纸不会变成 147mm。

最后提一句排查顺序:先确认打印对话框缩放是 100%,再跑上面的祖先链脚本,最后才怀疑字体和边距。字体变小不会让整页内容整齐地缩到 0.7,边距吃内容也不会左右留白等比例变大。数字对得上 0.7,就是缩放。