管理后台最烦的打印场景之一:Element Plus 的表格在屏幕上好好的,一 window.print() 就弹系统框,还把侧栏一起打出去。若业务要求柜面「点一下就出纸、指定打印机」,需要本机打印客户端;前端用 Vue3 接一层 SDK 即可。
结论先说清
- 纯浏览器方案难以稳定做到「无对话框 + 指定物理打印机」。
- 推荐链路:打印专用 HTML →
web-print-pdf→ 本机 Web打印专家客户端 → 系统队列。 - Element Plus 负责展示;打印时尽量不要直接裸打整个
el-table外层壳。
准备打印区域
<template>
<div>
<el-button type="primary" :loading="loading" @click="onPrint">静默打印</el-button>
<div ref="printRoot" class="print-root">
<h2>销售日报</h2>
<el-table :data="rows" border>
<el-table-column prop="name" label="商品" />
<el-table-column prop="qty" label="数量" />
</el-table>
</div>
</div>
</template>
<script setup>
import { ref } from 'vue';
import webPrintPdf from 'web-print-pdf';
const printRoot = ref(null);
const loading = ref(false);
const rows = ref([]);
async function onPrint() {
loading.value = true;
try {
if (!(await webPrintPdf.utils.getConnectStatus())) {
ElMessage.error('请先启动本机打印客户端');
return;
}
const html = printRoot.value?.innerHTML || '';
await webPrintPdf.printHtml(
html,
{
paperFormat: 'A4',
printBackground: true,
margin: { top: '8mm', bottom: '8mm', left: '8mm', right: '8mm' },
},
{ paperFormat: 'A4', printerName: '办公室-A4' },
{ action: 'print' }
);
} finally {
loading.value = false;
}
}
</script>
Element Plus 相关注意点
| 问题 | 处理 |
|---|---|
| 操作列、筛选被打出 | 打印容器不要包含这些节点 |
| 表头背景、斑马纹丢失 | printBackground: true |
| 大表分页 | 打印前拉全量数据或拼多段 HTML |
| 虚拟滚动 | 打印用全量数据单独渲染更稳 |
小结
Vue3 + Element Plus 做静默打印,难点在打印 DOM 是否干净、客户端是否在线、打印机名是否正确。用 web-print-pdf 做调用层即可。
npm install web-print-pdf