设计器里选了 58mm,预览条子也齐。一出纸:左边空一截、右边裁字,或者整张像被放大过。第一反应是「设计器不准」,多半冤。
直说吧:
设计器决定的是 HTML 里的版式;真正出纸还听 打印参数 + 驱动纸宽。三处有一处不一致,看起来就像「拖歪了」。
三处必须对齐
| 位置 | 管什么 | 常见错法 |
|---|---|---|
| 设计器纸型 | 画布宽度、元素坐标 | 按 80mm 拖,按 58mm 打 |
printHtml 参数 |
paperFormat、margin |
忘了传,默认 A4 |
| 打印机驱动 | 默认纸张、缩放 | 「适合页面」一开全乱 |
热敏机尤其狠:驱动里纸宽是 58,你参数写 80,客户端按 80 渲染,机器再硬塞进 58,左右必裁。
出纸参数跟模板走
import webPrintPdf from 'web-print-pdf';
async function print58Receipt(html, printerName) {
if (!(await webPrintPdf.utils.getConnectStatus())) {
throw new Error('本机打印客户端未运行');
}
return webPrintPdf.printHtml(
html,
{
paperFormat: '58mm',
printBackground: true,
// 小票一般顶满,套打/满版时四边 0;要留白就设计器里留,别两边各留一次
margin: {
top: '0', right: '0', bottom: '0', left: '0' },
},
{
printerName, copies: 1 },
{
action: 'print' }
);
}
调版时 action: 'preview',参数一字不改。预览已经歪,出纸不会自己变好;预览齐、纸上歪,再查驱动。
歪法对照表
| 纸上现象 | 优先怀疑 |
|---|---|
| 左右裁字 | paperFormat 比实纸宽;或驱动缩放 |
| 左边一条空白 | margin.left 又加了一刀;或设计器内容没贴左边 |
| 整体偏小、四周空 | 驱动「适合页面 / 缩放到可打印区域」 |
| 只有高度不对、宽度还行 | 内容高度估算;切纸位置另说,不是纸宽问题 |
| 预览 58 正常、出纸变 A4 | 出纸那次没带上 paperFormat |
58 和 80 不要混用同一份导出稿「差不多就行」。差 22mm,字号和换行都会跟着变;要两档就存两套模板,或两套参数配置,别运行时猜。
排障表
| 现象 | 先查 |
|---|---|
| 设计器预览齐、客户端预览歪 | 打印参数纸型/边距 |
| 客户端预览齐、实纸歪 | 驱动纸张、缩放、左右偏移 |
| 换一台同型号机又齐了 | 那台驱动默认纸不同 |
| 条码在设计器里好、纸上糊 | DPI/二值化问题,不是边距;另查热敏清晰度 |
拖模板解决的是「内容往哪放」。纸宽边距齐不齐,是设计稿、SDK 参数、驱动三方对表。对完表再怪设计器,才冤枉得少。