UniApp 小程序能静默打印吗?
不能直连 PC 客户端。请用工位 H5 + 客户端,或远程推送方案。
UniApp 编译为 H5 并在 Windows/macOS/Linux 浏览器中打开时,可像普通 Web 项目一样接入 web-print-pdf + 本地客户端实现静默打印。小程序 / App 原生容器无法直接驱动 PC 打印机,工位场景请使用 H5 或 远程推送 到 PC 出纸。
web-print-pdf(与 Vue 项目相同 API)UniApp H5 页面调用 printHtml → 本机 WebSocket 客户端 → 打印机。与 Vue 专题 相同;跨端代码可共用打印 HTML 模板。
在 <script setup> 或 Options API 中 import 并封装方法:
// #ifdef H5
import webPrintPdf from 'web-print-pdf';
export async function silentPrint(html) {
return webPrintPdf.printHtml(
html,
{ paperFormat: 'A4', printBackground: true },
{ printerName: 'Default printer' }
);
}
// #endif
<template>
<view>
<view id="print-area" v-html="reportHtml"></view>
<button @click="onPrint">Silent print</button>
</view>
</template>
<script setup>
// #ifdef H5
import { silentPrint } from '@/utils/print';
const onPrint = () => silentPrint(document.getElementById('print-area').innerHTML);
// #endif
</script>
微信小程序 / 支付宝小程序等无法连接用户 PC 上的 Web打印专家客户端;若业务必须在手机端触发、在 PC 出纸,请用服务端推送 + 工位 PC 客户端,见 远程打印。
#ifdef H5 内才 import web-print-pdf,避免小程序包体积报错。ref 获取 DOM,或拼接与 Vue 版相同的 HTML 字符串。uni.print 不同:后者多走系统对话框;web-print-pdf 实现静默与指定打印机。不能直连 PC 客户端。请用工位 H5 + 客户端,或远程推送方案。
printHtml API 相同;注意 UniApp 条件编译与 DOM 获取方式。
原生 App WebView 需评估 WebSocket 访问本地客户端;生产环境更推荐 H5 工位或远程打印。
需 WebView 能访问 127.0.0.1 WebSocket;生产环境更推荐 H5 工位或远程推送。
小程序将业务数据提交到自有服务端入队,由工位 PC 客户端连接你暴露的接口出纸;不是小程序内调 printHtml。见 WMS 与远程打印专题。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。