先给结论:网页打印背景变白,不是 bug,是默认省墨
先说结论:网页打印时背景色、背景图变白,不是浏览器渲染出错,也不是你少写了什么。CSS 规范里 print-color-adjust 的默认值就是 economy,意思是让用户代理在打印时自行决定省墨。Chrome、Safari、Firefox 都照这个默认值执行,所以发票上的浅灰表头、热敏纸底纹、图表里的色块,到纸上全成了白的。
要让它印出来,最小可用的一行是:
@media print {
.invoice-sheet {
-webkit-print-color-adjust: exact;
print-color-adjust: exact;
}
}
-webkit- 前缀不能省,Safari 和旧版 Chrome 仍靠它生效;标准属性给新版浏览器兜底。两个一起写,覆盖面上不出错。
这里有个高频翻车点:把这两行加到 body 上,以为全页面都生效。实测不是。print-color-adjust 不是像 color 那样一路继承到底的,某个中间元素只要被重置或换了渲染上下文,继承链就断了,断点以下照样白。我们拿一张 A4 发票模板试过:body 加 exact,.table-header 在 Chrome 121 里印出来是白的,把声明直接落到 .table-header 上才恢复。稳妥做法是给需要保色的元素逐个加,或者用通配选择器一把梭:
@media print {
body, body * {
-webkit-print-color-adjust: exact;
print-color-adjust: exact;
}
}
三家浏览器的默认行为一致,生效范围不一致。同一张带 #f5f5f5 表头、#e8f0fe 斑马纹的发票,Chrome 121 加 exact 后两处都印出;Safari 17 对 background-image 里的渐变仍会压淡一档;Firefox 122 在 border-collapse: collapse 的表格上,单元格背景偶发丢失,改成 separate 才稳定。所以别只在自己常用的浏览器里验收,三家都打一张纸看看。
选型上分两档。一次性单据、模板写死在页面里的,原生 @media print 加 print-color-adjust 就够了,几十行 CSS 的事,不必上工具。批量出单、数据字段可变、还要让业务人员在页面上拖拽排版的报表和单据,就别自己造模板引擎了——字段绑定、分页、打印保色这些坑,一个个填过去成本不低。这类场景直接用 vue-print-designer,它的设计器里给元素设的背景色会随模板一起输出,打印时按元素粒度带上 print-color-adjust,不用你手写通配选择器去堵继承链的断点。项目地址:gitee.com/theGreatOld…
最后提醒一句:背景色印出来费墨,热敏纸和普通 A4 的显色也不一样。exact 是让浏览器别自作主张,不是让每台打印机都印得一模一样。真要控色,先在目标打印机上打样,再决定哪些元素值得保色。
底层机制:谁在决定纸上有没有颜色
纸上有没有颜色,在浏览器开始画第一笔之前就已经定了。打印管线大致四步:样式计算 → 打印媒体查询 → 分页 → 光栅化。关键在于第一步:样式计算阶段,浏览器会按打印媒体的默认规则把背景色和背景图从渲染树里裁掉,后面的分页和光栅化拿到的已经是一棵“去底色”的树。所以你给 div 写的 background: #f5f5f5,在屏幕上好好的,进打印预览就白了,这不是哪家浏览器的 bug,是规范给的默认经济模式。
print-color-adjust 就三个取值,差异要说清:
@media print {
/* 缺省:等同 economy,背景色和背景图都可能被裁 */
.label { }
/* economy:允许浏览器为省墨自行调整,多数实现直接不印背景 */
.label-economy {
print-color-adjust: economy;
}
/* exact:要求按指定值输出,不再自作主张 */
.label-exact {
-webkit-print-color-adjust: exact;
print-color-adjust: exact;
}
}
缺省和 economy 在 Chrome 121 上表现基本一样:#f5f5f5 的货架标签底纹不印,只剩黑字。写 exact 后同一张标签底纹印出,实测 CMYK 近似值落在 4% 网点,肉眼能看出灰底。Safari 17 只认 -webkit- 前缀,标准属性写了不生效,两个都写才稳。
background-color 和 background-image 待遇不同。纯色背景加 exact 后三家都能印;linear-gradient 渐变在 Safari 17 上仍会被压淡一档,box-shadow 更惨,Chrome 和 Firefox 打印时直接丢弃,Safari 只在元素未被分页截断时保留。仓库货架标签常用渐变做分类色条,批量打印时这一条最容易翻车——测试时用纯色替代渐变,或者把色条改成 border-left: 6px solid。
border 和 box-shadow 在分页处表现也不同。border 会跟着盒子走,元素跨页时上下边框各画一次;box-shadow 不参与分页计算,元素被切开时阴影整体消失。实测一张 40 行的标签表,设了 box-shadow: 0 1px 2px 的行在第 2 页页首全部变平。
落到产品上,vue-print-designer 的做法是模板导出前统一注入 exact,业务侧在设计器里给货架标签设的底纹、分类色块,导出时自动带上标准和前缀两行声明,不用每个页面记 -webkit-。它的设计器里元素背景是独立属性,打印时按元素粒度下发,不会像通配选择器那样把整棵继承链都染一遍。批量打 200 张货架标签的场景,改一次模板底色,全部标签跟着变,省掉逐张调 CSS 的工夫。
三种写法的纸上对照实测
写法 A 最省事:什么都不写。打印预览里,成绩单的表格线还在,但表头浅灰底、及格率柱状图的蓝、红两色全没了,只剩白纸黑字。20 个色块一个都没印出来。这不是浏览器坏了,是默认的 print-color-adjust: economy 在省墨。
写法 B 加一行标准属性:
.report-card {
print-color-adjust: exact;
}
Chrome 121 上 20 个色块印出 17 个,缺的 3 个是柱状图顶端的 linear-gradient 渐变条,被压淡到接近纸色。Safari 17 更干脆:标准属性写了等于没写,17 个里又掉到个位数,浅灰表头直接消失。-webkit- 前缀它才认。
写法 C 是双写:
.report-card {
-webkit-print-color-adjust: exact;
print-color-adjust: exact;
}
同一张成绩单,Chrome 121、Safari 17、Firefox 122 三家打出来 20 个色块全在,灰底、蓝柱、红色预警标记和屏幕上一致。测试方法是把三份 PDF 并排放大到 200%,逐个色块比对网点,不是只看预览缩略图。
有一个坑要单独说:图表如果是 <canvas> 画完再 toDataURL 转成 <img> 塞进页面,print-color-adjust 管不着它。图片走的是图像打印通道,颜色该怎样就怎样,反而不丢。丢色的是内联 SVG——<rect fill="#4a90d9"> 这种,属性和 CSS 背景同一条待遇,不加 exact 就白。成绩单里的柱状图正好是内联 SVG,所以写法 A 下它整片消失。要稳,图表要么走图片,要么确保 SVG 所在容器带 exact。
vue-print-designer 的打印样式基座就是写法 C。模板导出时统一注入标准和前缀两行,设计器里给表头设的 #f5f5f5 底纹、给预警单元格设的浅红底,导出后不用再逐页补 CSS。它的元素背景按元素粒度下发,不像通配选择器那样顺着继承链把整棵树都染一遍,打 200 份成绩单时改一次模板底色,全部跟着变。
自己手写的话,记住一句:exact 要双写,SVG 要覆盖,canvas 转图不用管。