企业的打印需求,终于有解了:OpenPrint 开源打印设计器全解析

0 阅读5分钟

企业的打印需求,终于有解了:OpenPrint 开源打印设计器全解析

关键词:打印设计器 / 开源 / 框架无关 / AI 生成 / ERP 对接

做企业级系统的同学,几乎都绕不开一个反直觉的"低频高痛"需求——打印。

快递面单、商品标签、出库单、发票、报表,形态天差地别,可一旦要改一版,就牵一发动全身:前端写死模板 → 改代码 → 发版 → 客户再说"位置偏了 0.5 毫米" → 再来一轮。一个打印模板的迭代周期,硬生生被拉长到以"周"为单位。

直到我项目里接入了 OpenPrint,才把"改打印模板"从开发者的职责里彻底摘出去。

圖片.png

它是什么

OpenPrint 是一款开源、纯前端、零后端依赖的 Web 打印模板可视化设计器:

  • 拖拽设计快递面单、标签、报表,所见即所得;
  • AI 一句话生成模板;
  • 核心引擎与 UI 层解耦,框架无关,React / Vue / Angular / 原生 JS 都能接;
  • Web 直接打印、C++ 桌面静默打印、云打印三轨并行。
纯前端架构,无需服务器,无需数据库,一个浏览器即可运行。

圖片.png

拖拽式可视化设计

浏览器打开就能用。控件库内置 10 种控件:文本、图片、矩形、圆形、线条、条码、二维码、表格、富文本、图表。

自由拖拽 + 吸附对齐 + 标尺辅助;多页设计,每页独立页眉页脚;JSON / CSV / API 多种数据源绑定;模板本地存储、导入导出;预览数据效果实时呈现,支持 PDF / JPG / SVG / HTML 多格式导出。

AI 一句话生成模板

这是我最喜欢的一点——直接上自然语言:

帮我生成一张快递面单,含收件人、寄件人和运单号条码

AI 自动创建模板 → 布局文本控件 → 添加条码 → 一键使用。整个过程 10 秒内完成。

它支持三种用法:新建模板(输入需求直接生成)、修改当前模板(选中控件让 AI 调整布局样式)、字段接地(自动识别数据字段并绑定到模板控件)。底层是 LLM 解析意图 → 输出结构化模板描述 → 规范引擎转成 Fabric.js 控件配置。

框架无关:这才是技术选型的底气

OpenPrint 最大的技术亮点是引擎与 UI 彻底解耦:

┌─────────────────────────────────────────────────────┐
│             UI 层(可替换,官方为 Vue 3)             │
│   React  │  Vue  │  Angular  │  原生 JS / Web Comps  │
└───────────────────────┬─────────────────────────────┘
                        │ SDK API
┌───────────────────────┼─────────────────────────────┐
│       引擎层(框架无关,纯 TypeScript)               │
│   排版引擎:数据绑定/分页/表格/分组/表达式           │
│   渲染引擎:HTML / PDF / JPG / SVG 导出             │
└───────────────────────┼─────────────────────────────┘
                        ▼
            ┌───────────┴──────────┐
            │ C++ Qt 静默打印客户端  │  云打印服务
            └───────────────────────┘

也就是说,不管你的业务是 React 还是 React Native,引擎层都能直接复用,UI 层想换随时换。

三种接入方式随你选

① React 项目:引擎直接渲染

import { useEffect, useRef } from 'react'
import { render } from 'openprint26'
​
export default function App() {
  const ref = useRef<HTMLDivElement>(null)
  useEffect(() => {
    render({ template: templateJson, data }).then(({ html, pages }) => {
      ref.current!.innerHTML = html
      console.log('共', pages, '页')
    })
  }, [])
  return <div ref={ref} />
}

② 原生 JS / 任意框架:渲染 + 导出

import { render, createHeadless } from 'openprint26'
​
// 渲染 HTML
const { html } = await render({ template, data })
document.getElementById('print-area').innerHTML = html
​
// 导出 PDF
const headless = createHeadless()
const { blobs, filenames } = await headless.exportPdf({ template, data })
blobs.forEach((b, i) => downloadBlob(b, filenames[i]))
headless.dispose()

③ Vue 项目:嵌入完整设计器

import { definePrintDesigner } from 'openprint26'
definePrintDesigner() // 注册 <print-designer>
<print-designer license-key="..." style="height:820px"></print-designer>

设计器以 iframe 薄桥接嵌入,宿主侧零框架依赖,内置设计器约 5.9 MB / gzip 1.9 MB,按需动态加载,只在用到时才下载。

体积与性能

  • 核心引擎约 190 kB(gzip ~57 kB)
  • 条码、二维码、公式(KaTeX)与 jspdf 均按需加载,模板里没有对应控件就不会下载
  • 实测业务项目 vite build 后入口主包仅 1.6 kB,其余走按需 chunk

对企业级系统来说,这个侵入成本几乎可以忽略。

Excel 批量打印

上传 Excel 自动识别列 → 自动映射字段 → 一行数据一张标签,99 行批量输出 99 张。流水号支持「分类-年份-序号」自定义规则(如 ZC-2026-0158),批量前逐条预览校验避免打错。

打印链路完整

方式场景特点
Web 直接打印单机/少量浏览器调系统打印对话框
桌面静默打印批量/自动化C++ Qt 客户端,零弹窗
云打印多门店/远程打印队列、断线重试、日志审计

桌面客户端自带任务看板、打印机管理、实时日志,还能配置云端中继做远程连接。

适用场景

  • 电商 / 物流:快递面单、物流标签
  • 仓储 / 制造:SKU 标、资产标、流水线 SN 码
  • 零售 / 餐饮:收银小票
  • 财务:发票、收据
  • 企业系统:ERP / 进销存 / WMS 接入打印能力

总结

OpenPrint 的核心价值一句话:把"改打印模板"从开发者的工作中剥离,交给业务人员拖拽完成。

开发只要做一次对接,后面模板怎么改、怎么加、怎么调样式,都不再占用你的排期。这对做企业内部系统、做独立交付的朋友来说,价值是实打实的。

如果这正好戳中你的痛点,不妨 clone 下来跑一跑:

git clone https://gitee.com/haiming236/openprint.git
cd open-print && pnpm install && pnpm dev

环境要求 Node.js >= 22.18.0、pnpm >= 9.x。

有帮到你,欢迎点赞、收藏、转发;有问题评论区见。