web直接打印服务，解决前端打印烦恼

一、介绍

浏览器本身虽具有打印功能，也只是勉强“可用”，还远远满足不了人们的打印需求；在直接打印和打印模板设计方面，要想达到比较理想的打印输出效果，困难很大。因此为了解决这个问题，就开发了WebPrintServer。

WebPrintServer是提供给前端开发者使用的打印服务插件，简单易用、功能强大、高效稳定、输出一致的打印控件/插件/服务，它带给开发者和最终用户的体验堪称完美。可以直接通过服务提供的api进行打印、打印预览、获取打印机列表、导出，等功能。

主要功能：

1、模板+JSON=打印输出，模板设计所见即所得，开发效率超高，任意输出样式皆可唾手可得。

2、定位精准、输出清晰精度高，无论文字、条码（二维码）、图像、表格...

3、不同浏览器打印输严格一致，无论预览还是打印输出。

4、系统具有卓越的稳定性、出色的开发和运行效率，可以快速响应客户各种需求变化，并能够为你成倍地节约开发和维护成本。

二、操作说明

1、启动

（1）双击打开“WebPrintServer.exe”，服务在任务栏右边运行，如下图。

（2）鼠标右击服务，显示菜单，显示/关闭菜单，点击“显示”菜单，显示主界面。

2、主界面

（1）显示主界面

（2）点击服务运行中，显示密码框。

（3）输入密码，初始密码默认为“1”。

（4）输入密码后，按键盘“回车”按键，显示可设置参数。

（5）设置API地址，本机api地址，需注意，api地址要以“/”结尾。

（6）设置完后，点击“设置”按钮，如果没有提示报错，则保存成功。

3、模板设计

（1）点击主界面“模板设计”按钮，展示模板设计界面。

（2）点击“新建模板”按钮，新建出模板，可以直接设计要打印/导出的模板，然后点击“保存”按钮，保存的路径这里有要求要将模板放到，服务目录下的“template”目录下面。

（3）设计完模板，添加绑定模板json数据。点击“数据”按钮，跳出数据窗口。将json数据添加后保存。

4、打印测试

（1）点击主界面中的“打印测试”按钮，可以测试之前设计的模板。

5、API调用

测试地址：模板打印 - 打印服务

（1）打印API：

http://127.0.0.1:3333/print/?api=print&temple=模板名称&data=模板绑定数据&preview=预览

入参说明:

api：API名称值为print。

temple：模板名称，模板设计后保存的模板名称。

data：模板绑定的JSON数据。

preview：预览标识，1：预览报告，0：直接打印

printer：打印机名称，如果不设置则，从默认打印机打印。

出参说明：

{code = "", message = ""}

code：返回代码，1：代表api响应成功，否则为失败。

message：返回消息内容。

（2）导出API：

http://127.0.0.1:3333/print/?api=export&temple=模板名称&data=模板绑定数据&path=导出路径&format=导出格式

入参说明:

api：API名称值为export。

temple：模板名称，模板设计后保存的模板名称。

data：模板绑定的JSON数据。

path：导出路径，导出文件的绝对路径。

format：导出格式，值：pdf：导出pdf，image：导出jpg图像，html：导出html文件。

出参说明：

{code = "", message = ""}

code：返回代码，1：代表api响应成功，否则为失败。

message：返回消息内容。

（3）获取打印机列表：http://127.0.0.1:3333/print/?api=printer

入参说明:

api：API名称值为printer。

出参说明：

{

    "code": "1",

    "message": "获取打印机成功！",

    "data": [

        "导出为WPS PDF",

        "OneNote for Windows 10",

        "Microsoft XPS Document Writer",

        "Microsoft Print to PDF",

        "Fax"

    ]

}

code：返回代码，1：代表api响应成功，否则为失败。

message：返回消息内容。

data：打印机列表