UniApp H5 与桌面客户端静默打印

UniApp 编译为 H5 并在 Windows/macOS/Linux 浏览器中打开时,可像普通 Web 项目一样接入 web-print-pdf + 本地客户端实现静默打印。小程序 / App 原生容器无法直接驱动 PC 打印机,工位场景请使用 H5 或 远程推送 到 PC 出纸。

适用场景与准备

  • 目标终端为 PC 浏览器 H5(WMS 工位、收银、内网 OA)并安装 Web打印专家客户端
  • H5 工程通过 npm 或 static 方式引入 web-print-pdf(与 Vue 项目相同 API)

架构说明

UniApp H5 页面调用 printHtml → 本机 WebSocket 客户端 → 打印机。与 Vue 专题 相同;跨端代码可共用打印 HTML 模板。

UniApp H5 调用示例

在 <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 字符串。
  • 内网 H5 部署后,确认客户端 WebSocket 端口未被安全软件拦截。
  • 与 uni.print 不同:后者多走系统对话框;web-print-pdf 实现静默与指定打印机。

与本站专题分工

常见问题

UniApp 小程序能静默打印吗?

不能直连 PC 客户端。请用工位 H5 + 客户端,或远程推送方案。

H5 和 Vue 项目有区别吗?

printHtml API 相同;注意 UniApp 条件编译与 DOM 获取方式。

App 打包能打印吗?

原生 App WebView 需评估 WebSocket 访问本地客户端;生产环境更推荐 H5 工位或远程打印。

App WebView 能连本地客户端吗?

需 WebView 能访问 127.0.0.1 WebSocket;生产环境更推荐 H5 工位或远程推送。

多端小程序 + PC 打印怎么架构?

小程序将业务数据提交到自有服务端入队,由工位 PC 客户端连接你暴露的接口出纸;不是小程序内调 printHtml。见 WMS 与远程打印专题。

各平台客户端部署

同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。

免费下载客户端 查看 npm 包 开发文档