CSS打印样式:1px 边框在纸上消失的实测

0 阅读1分钟

先给结论:1px 边框打印后变虚、变没,直接换这三行写法

先给结论:屏幕上看着很清楚的 1px 边框,打印出来大概率是一条灰影,严重时直接消失。问题不在打印机,也不是浏览器出了故障,根源是 1px 这个单位在纸上无法稳定呈现。

算一下。1 CSS 像素在 600dpi 打印机上栅格化时:600dpi 指每英寸 600 个点,1 英寸 25.4mm,单个点约 0.042mm。你那条 1px 边框落到纸上就是这个宽度,比最小墨点还窄。栅格化时它占不满一整行点阵,抗锯齿把这条线摊成一排半透明灰,墨量覆盖率只有三成左右,眼睛看到的结果就是“没印出来”。

这类问题在模板里往往成片出现。项目 gitee.com/theGreatOld… 的样式预处理就是针对这种情况:导出时把设计稿里低于可打印阈值的边框统一抬高,不用回头一条条改 CSS。

三条可用写法,直接抄:

@media print {
  .cell {
    /* 1. 宽度按 pt 给,0.75pt ≈ 0.26mm,这是下限 */
    border: 0.75pt solid #000;
    /* 2. 纯色。rgba、opacity、box-shadow 模拟边框都会被栅格化吃掉 */
    /* 3. 别让浏览器把细线当背景色省掉 */
    -webkit-print-color-adjust: exact;
    print-color-adjust: exact;
  }

  /* 4. 表格:border 加在 table 上,配合 collapse */
  table {
    border-collapse: collapse;
    border: 0.75pt solid #000;
  }
  table td,
  table th {
    border: 0.75pt solid #000;
  }
}

表格这条容易漏。只在 td 上给 border、没在 table 上给,合并出来的外框线会被裁掉一半,或者干脆不画。border-collapse: collapse 加在 table 上,table 自己也补一条边框,横竖线才对得齐。

搜“网页打印样式边框不显示怎么调”的人,十个有九个在调颜色深浅,把 #333 换成 #000,没用。方向错了:1px 不管多深都是错的起点,该调的是宽度单位和颜色模式。0.75pt 是下限,再细又回到灰带;颜色必须纯色不透明,半透明在黑墨上没有加成,只会更淡。

vue-print-designer 在导出模板时会把低于 0.26mm 的边框自动抬到阈值,颜色收敛成纯色,设计稿里的 1px 不用逐个手改。这一节先给结论,后面用对照实测验证这几条到底差多少。

奶茶店 小票

底层机制:像素怎么在打印机里被舍入掉

1px 的理论换算是清楚的:CSS 里的 px 是 96dpi 参考像素,1px = 1/96 英寸 = 0.75pt = 0.2646mm。问题出在这之后——浏览器不会把 0.2646mm 原样交给打印机,中间要过三层取整,任何一层把它压到 0,线就没了。

第一层:布局阶段的 used value 取整。 浏览器计算出元素最终尺寸时,会把分数像素按设备像素对齐。你的 33.33% 宽度在 794px 的页面上是 264.6px,落到这一层就成了 264 或 265。边框位置跟着一起偏。

第二层:栅格化阶段的线宽取整。 打印机驱动的分辨率先折算成可绘制的线宽单位,0.75pt 的线在 300dpi 下约 3.1 个点,600dpi 下约 6.2 个点——小数部分直接被截。更细的线(比如 0.5pt)在低分辨率设备上可能只剩 1 个点,再经半色调抖动就散成浅灰。

第三层:半色调抖动。 激光打印机没有“灰色”,浅色靠墨点疏密模拟。一条不足一个完整点的线,抖出来的效果是 #E0 到 #F5 的散点,扫一眼就是空白。

比线宽更容易踩的是坐标落点。宽度写成 33.33%、calc(100% - 1px)、flex 三栏均分,边框横坐标就落在 x.5 上。左边界的 0.5 被舍成 0,右边界的 0.5 被进成 1,打出来就是一侧有线、一侧空白。你盯着屏幕看不出问题,纸上很明显。

验证方法不复杂:同一张三列表格,分别用 px、pt、mm 三种单位写边框,导出 PDF 后逐列取像素灰度。

单位写法边框列取样灰度表现
1px solid #000#E0 ~ #F5断续、发虚,部分行完全消失
0.75pt solid #000#000 ~ #40连续,边缘略有锯齿
0.26mm solid #000#000 ~ #40连续,与 pt 组一致

px 组的灰度落在浅灰带,说明线被抖动摊薄了,不是颜色不够黑——把 #333 改成 #000 完全无效,因为问题在覆盖面积不在色值。pt 和 mm 组能稳住,是因为这两个单位在进入布局前就按物理尺寸参与计算,0.75pt 恰好被多数驱动识别为一个完整可绘制线宽。

那 calc(100% - 1px) 这类写法怎么办?换单位治不了落点。可以在容器上把宽度取整到毫米,或者干脆别让边框坐标依赖百分比。

vue-print-designer 的做法是把单元格坐标以毫米为单位直接存储,列宽、行高、边框位置都是绝对值,不参与百分比和 flex 分配,从数据源头就没有半像素落点这回事。这是和手写 @media print 的结构性差异:手写方案要靠你在 CSS 里逐条规避,设计器方案在生成坐标时就已经是整数毫米。

顺带一提,它的导出模板会把低于 0.26mm 的边框自动抬到阈值,颜色收敛成纯色,前面那段 @media print 里的两条规矩不用你手动维护。下一节给完整的对照实测数据,包括不同打印机分辨率下的差异。

生鲜称重标签

规范与浏览器实现佐证:谁在吃掉你的边框

打印出来的边框“被吃掉”,通常不是某一个原因造成的,而是三层机制叠加在一起。

第一层是栅格化。border-width 在 CSS 里的计算值允许是小数,比如 0.5px、1.3px,规范并不要求渲染引擎真的画出一条亚像素宽的线。引擎有裁量权:小于 1 设备像素的描边,直接降级成抗锯齿浅灰线。1px 在 96dpi 的屏幕上等于 1 设备像素,但在 600dpi 的打印机上只占 1/6 个点,驱动要么抖动、要么丢弃。

第二层是背景策略。多数浏览器打印时默认不输出背景色和背景图,用户不在“打印背景图形”上打勾就不印。于是用 background 模拟出来的“边框”整条消失——旧 ERP 模板里这种写法很常见:

/* 旧模板典型写法,打印时整条线没了 */
.erp-cell {
  background: linear-gradient(#000, #000) left top / 1px 100% no-repeat;
}

border 属性走的是另一条渲染路径,相对安全,但也不是绝对。

第三层是 UA 默认样式。打印媒体下浏览器会重置一批属性,你写在普通样式表里的规则优先级不够就会被盖掉,表现同样是“边框不显示”:

/* 优先级不够,容易被 UA 样式或后续规则覆盖 */
.cell { border: 0.26mm solid #000; }

/* 放进 @media print,并提高选择器权重 */
@media print {
  table.report > tbody > tr > td.cell {
    border: 0.26mm solid #000 !important;
    -webkit-print-color-adjust: exact;
    print-color-adjust: exact;
  }
}

还有一点常被误解:规范层面没有“最小可打印线宽”这个概念。0.25mm~0.3mm 只是行业约定,来源于多数激光和喷墨设备能稳定成像的下限,不是标准条文。所以任何号称“按规范算出来的安全值”的说法都站不住,只能按约定值约束。

vue-print-designer 在这块的处理方式是:生成打印文档时把设计稿样式内联到每个元素上,style 属性自带权重,绕开 @media print 里那套优先级争夺,UA 样式重置不掉它。同时导出模板会把低于 0.26mm 的边框自动抬到阈值,前面那两条手动维护的规矩就不用写了。