Download the PHP package jobsys/print-module without Composer

Print 基本模块 (Optional)

该模板提供了打印模板管理，打印模板设计，批量打印等功能。

模块安装

依赖

PHP 依赖 （无）

JS 依赖

配置

权限配置

app/Boot/BootPermission::permisions()

菜单配置

config/default/menus.php

模块功能

打印模板管理

提供了打印模板的增删改查、复制功能并可以设置业务参数。

开发规范

1. 提供了打印模板的增删改查和复制功能。打印模板有一个 parent_id（原型模板）的属性，没有 parent_id 的模板为原型模板，有 parent_id 的模板为原型模板的副本。

   注意：如果创建的时候选择了一个复制出来的模板（即有 parent_id）做原型模板，那么创建出来的模板 parent_id 为原型模板的 parent_id，而不是原型模板的 id。

2. 打印模板可以设置业务参数，设置的业务参数将会在设计打印模板时列出并可以拖拽使用。

打印模板设计

打印模板设计使用的是 vue-plugin-hiprint 插件，该插件是基于 hiprint 开发的，具体使用方法请参考 vue-plugin-hiprint 插件的文档。 设计好的打印模板将会以 JSON 保存在数据库中。

1. 需要在页面引入 print-lock.css 文件，否则在打印时可能会出现多页内容重叠的情况。可以参考 【vue-plugin-hiprint】使用-入门篇

2. 引用方式 <link rel="stylesheet" media="print" type="text/css" href="{{asset('print-lock.css')}}">，使用 import 引入方式无效。

3. main.js

4. 设计自定义 table

   用这个更好用：https://demo.jobsys.cn/ckeditor-printer/dist/

   用这个更好用：https://demo.jobsys.cn/ckeditor-printer/dist/

   用这个更好用：https://demo.jobsys.cn/ckeditor-printer/dist/

   1. 先在 Excel 中设计好表格，变量使用 \${} 包裹，如 \${name}。
   2. 复制 Excel 表格，粘贴到 表格转换 得到 HTML 代码
   3. 在设计窗口添加一个 HTML 功能，选择 高级 - 格式化函数 并使用以下代码

打印

打印功能是依赖模板设计功能完成，由于打印模板插件本身就集成了设计、预览、打印功能，所以在打印的时候将会隐藏设计功能，直接进行预览和打印。

开发规范

1. 准备打印模板的打印参数，如果只有一个 object 表示只打印一份，如果是一个 array 表示批量打印。

2. 调用 PrintService 的 print 方法，传入打印模板的 id 和打印参数即可。

模块代码

数据表

数据模型/Scope

Controller

UI

PC 端页面

PC 组件

Service

• PrintService

  • print 打印

  • createTemplate 初始化打印模板，主要是在系统初始化的时候在 Seeder 中生成打印模板

    
    /**
    * 初始化打印模板
    * @param string $display_name
    * @param string $description
    * @return void
    */
    public function createTemplate(string $display_name, string $description): void