1 Star 0 Fork 880

kaisr / vue-plugin-hiprint

forked from CcSimple / vue-plugin-hiprint 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
CHANGELOG.md 24.17 KB
一键复制 编辑 原始数据 按行查看 历史
CcSimple 提交于 2023-03-09 17:27 . 0.0.48-changelog

版本及更新记录

💐️ GitHub 提交 PR 合并后可自动发布到 npm 仓库;

💐 同时自动更新 GitHub Pages 同步 Gitee;

💐 感谢各位贡献者的支持。 🔥

0.0.48 (2023-03-09)

1. ✨ 调整优化 setHost 支持回调
hiprint.hiwebSocket.setHost('http://localhost:17521',(connected, e) => {
  console.log('connected', connected);
  console.log('e', e);
})
2. ✨ 调整优化 参数 draggable:false 时,不显示删除按钮
3. ✨ 调整优化 design 网格线支持多面板
4. 🐛️ fix 竖线无法旋转 bug
5. 🐛️ fix hiprint.init error

0.0.46 (2023-02-23)

01. 🌈️ 新增支持 多面板名称自定义功能(创建模板添加 "onPanelAddClick" 和 "defaultPanelName" 属性)
let hiprintTemplate = new hiprint.PrintTemplate({
  template: {},
  settingContainer: '#PrintElementOptionSetting',
  paginationContainer: '.hiprint-printPagination',
  defaultPanelName: '默认面板名称', // 默认面板名称(当面板没有 name 属性时)
  onPanelAddClick: (panel, createPanel) => {
    // 修改名称, 可以弹出输入框, 也可以直接修改
    panel.name = '新面板' + (panel.index+1);
    // 记得 调用 createPanel 创建面板
    createPanel(panel);
  },
});
02. 🌈️ 新增支持 吸附线功能 && 优化调整吸附功能 支持设置 吸附阈值等 adsorbMin、showAdsorbLine、adsorbLineMin
hiprint.setConfig({
  adsorbMin: 3, //吸附最小距离pt
  showAdsorbLine: true, //显示吸附线
  adsorbLineMin: 6, //吸附线显示最小距离pt
})
03. 🌈️ 新增支持 table 分组字段函数 和 分组头/脚格式化函数
{
    options: {
      // 分组统计字段
      groupFieldsFormatter: function(groupData,options) {
          return ["name"];
      }
      // 分组表头
      groupFormatter: function(groupData,options) {
          return '<td></td>';
      }
      // 分组表脚
      groupFooterFormatter: function(groupData,options) {
          return '<td></td>';
      }
    }
}
04. 🌈️ 新增支持 design 显示网格 -> design('#id',{ grid: true })
let hiprintTemplate = new hiprint.PrintTemplate({
  template: {},
  settingContainer: '#PrintElementOptionSetting',
});
hiprintTemplate.design('#id',{ grid: true });
05. 🌈️ 新增支持 模板获取测试数据Api getTestData
06. 🌈 新增支持 表格列 表格头样式函数 @PromiseAll
07. ✨ 调整优化 update功能,支持更新多面板,并选中默认面板 eg: update({},1)
08. ✨ 调整优化 更改纸张大小时,按比例设置页脚线高度
09. ✨ 调整优化 双击编辑文本时 hover 显示问题
10. ✨ 调整优化 多面板 样式美化
11. 🐛️ fix 多表格 并排问题
12. 🐛️ fix 页眉线/页尾线 宽度问题
13. 🐛️ fix 多选元素 拖拽未选中元素 bug
14. 🐛️ fix 元素旋转 缩放后 点击跳动问题
15. 🐛️ fix 框选时遇hover停滞问题
16. 🐛️ fix 其他一些已知小bug

0.0.44 (2023-01-18)

1. 🌈️ 选中元素新增删除按钮
2. ✨ 调整优化 页码格式 支持 ${paperNo+1} 增量页码
3. ✨ 调整优化 新拖拽元素宽高大小显示
4. ✨ 调整优化 hover元素时显示删除按钮及宽高大小
5. ✨ 调整优化 当图片元素没设置宽高时,获取宽高大小
6. ✨ 调整优化 常见错误 Error 中文提示; 如 tableCustom
7. 🐛️ fix 框选后 getSelectEls 无法获取选中元素 bug
8. 🐛️ fix table 设置表体行高 自动填充 bug

0.0.40 (2022-12-26)

1. 🌈️ 新增支持 文本、表格聚合添加「转大小写」功能 同时提供 hinnn.toUpperCase 方法
hinnn.toUpperCase('0',10.8) // 十点八
hinnn.toUpperCase('5',10.8) // 人民币壹拾元捌角
hinnn.toUpperCase('7',10.8) // 壹拾元捌角零分
2. 🌈️ 新增 表格列"单元格渲染函数"实现自定义单元格内容
// eg: 自定义渲染进度条样式
function(value,row,index,options) {
    return `<progress value='${value}' max="1000"></progress>`;
}
3. ✨ 调整优化 放大/缩小时拖拽元素偏移问题, 缩放后拖拽不进设计器的问题
4. ✨ 调整优化 table列 编辑相关问题
5. 🐛️ fix 表格"自动补全"导致底部元素重叠bug
6. 🐛️ fix 'table' 默认可编辑,插入 bug

0.0.38 (2022-10-29)

1. 🌈️ 新增支持 设置 table列 底部聚合文本(tableSummaryText: '自定义文本)
2. 🌈️ 新增支持 设置 table列 底部聚合类型左右对齐方式(tableSummaryAlign: 'left/center/right')
3. 🌈️ 新增支持 设置 table列 底部聚合小数位(tableSummaryNumFormat: '0/1/2/3/4/5/6')
4. 🌈️ 新增支持 编辑查看 table "空白列"
5. ✨ 调整优化 table【多行表头合并】导致"数据错位"及"底部聚合函数"问题
6. ✨ 调整优化 table ⚠️ options: "fields"(列字段列表) "tableFields"(表格字段列表)
7. ✨ 调整优化 table列 底部聚合类型(tableSummary) 支持 text (仅显示设置的文本)
8. 🐛️ fix 模板内"多表格"分页/卡死问题
9. 🐛️ fix 一些已知bug (点击看详情)
1.fix toPdf options isDownload bug (toPdf 传3个参数时未正常导出pdf问题)
2.fix size-box font-family bug
3.fix 多行表头编辑bug
4.fix table 卡死问题(模板内"多表格"分页问题)
5.fix table tableSummaryTitle(底部聚合标题) 参数bug

0.0.36-fix (2022-10-11)

1. 🐛️ fix webpack/vue2.x npm 引入错误

0.0.36 (2022-10-10)

1. ⚠️ 移除 'tableCustom' 元素 'table' 默认可编辑,插入
2. 🐛 fix 辅助元素 错位问题
3. ✨ 调整优化 支持 cdn 引入 (非vue环境也可正常使用)
<head>
    <!-- 打印样式是必须的,你可以调整成自由链接, 注意名称 print-lock.css -->
    <link rel="stylesheet" type="text/css" media="print" href="https://unpkg.com/vue-plugin-hiprint@0.0.36/dist/print-lock.css" />
    <!-- 下列使用的都是 unpkg提供的 稳定性未知, 建议下载自行处理  -->
    <!-- jquery 必须 -->
    <script src="https://unpkg.com/jquery@3.6.1/dist/jquery.js"></script>
    <!-- 条形码 -->
    <script src="https://unpkg.com/jsbarcode@3.11.5/dist/JsBarcode.all.min.js"></script>
    <!-- 颜色选择器 -->
    <script src="https://unpkg.com/@claviska/jquery-minicolors@2.3.6/jquery.minicolors.min.js"></script>
    <!-- 直接打印(print2)需要 -->
    <script src="https://unpkg.com/socket.io-client@4.5.1/dist/socket.io.min.js"></script>
    <!-- toPdf需要 -->
    <script src="https://unpkg.com/canvg@3.0.10/lib/umd.js"></script>
    <script src="https://unpkg.com/jspdf@2.5.1/dist/jspdf.umd.min.js"></script>
    <script src="https://unpkg.com/html2canvas@1.4.1/dist/html2canvas.js"></script>
    <!-- vue-plugin-hiprint 😃 -->
    <script src="https://unpkg.com/vue-plugin-hiprint@0.0.36/dist/vue-plugin-hiprint.js"></script>
</head>
<body>
<!-- 注意 defer -->
<script defer>
  console.log('vue-plugin-hiprint')
  console.log(window['vue-plugin-hiprint'])
  console.log('hiprint')
  // hiprint 以注入 全局
  console.log(hiprint)
  var autoConnect = window['vue-plugin-hiprint'].autoConnect,
    disAutoConnect = window['vue-plugin-hiprint'].disAutoConnect,
    defaultElementTypeProvider = window['vue-plugin-hiprint'].defaultElementTypeProvider;
</script>
</body>

0.0.35 (2022-10-10) beta版

1. ⚠️ 移除 'tableCustom' 元素 'table' 默认可编辑,插入

0.0.34-fix (2022-10-10)

1. 🐛 fix 辅助元素 错位问题
2. ✨ 调整优化 支持 cdn 引入 (非vue环境也可正常使用)
<head>
    <!-- 打印样式是必须的,你可以调整成自由链接, 注意名称 print-lock.css -->
    <link rel="stylesheet" type="text/css" media="print" href="https://unpkg.com/vue-plugin-hiprint@0.0.34/dist/print-lock.css" />
    <!-- 下列使用的都是 unpkg提供的 稳定性未知, 建议下载自行处理  -->
    <!-- jquery 必须 -->
    <script src="https://unpkg.com/jquery@3.6.1/dist/jquery.js"></script>
    <!-- 条形码 -->
    <script src="https://unpkg.com/jsbarcode@3.11.5/dist/JsBarcode.all.min.js"></script>
    <!-- 颜色选择器 -->
    <script src="https://unpkg.com/@claviska/jquery-minicolors@2.3.6/jquery.minicolors.min.js"></script>
    <!-- 直接打印(print2)需要 -->
    <script src="https://unpkg.com/socket.io-client@4.5.1/dist/socket.io.min.js"></script>
    <!-- toPdf需要 -->
    <script src="https://unpkg.com/browse/canvg@4.0.1/dist/index.cjs"></script>
    <script src="https://unpkg.com/jspdf@2.5.1/dist/jspdf.umd.min.js"></script>
    <script src="https://unpkg.com/html2canvas@1.4.1/dist/html2canvas.js"></script>
    <!-- vue-plugin-hiprint 😃 -->
    <script src="https://unpkg.com/vue-plugin-hiprint@0.0.34/dist/vue-plugin-hiprint.js"></script>
</head>

0.0.32-fix (2022-09-29)

1. 🐛 fix 双击编辑后 拖拽/选中 系列bug
2. 🐛 fix 双击编辑 回车/点击其他元素/面板 确认编辑的bug

0.0.32 (2022-09-28)

1. 🌈 新增支持 双击编辑 text 元素
2. 🌈 新增 列参数: tableSummaryTitle 设置是否显示聚合函数标题
3. 🌈 新增 参数: pageBreak 强制分页(让元素下一页开始打印)
4. 🐛 fix 旋转后 拖拽 边界限制 bug
5. 🐛 fix 表格 "一行多组" bug

0.0.30 (2022-09-01)

1. 🌈 新增支持 选择图片后根据原始宽高自定义调整元素宽高
hiprintTemplate = new hiprint.PrintTemplate({
  onImageChooseClick: (target) => {
    // 测试 3秒后修改图片地址值
    setTimeout(() => {
      // target.refresh(url,options,callback)
      // 自定义处理
      // target.refresh(url,false,(el,width,height)=>{
      //   el.options.width = width;
      //   el.designTarget.css('width', width + "pt");
      //   el.designTarget.children('.resize-panel').trigger($.Event('click'));
      // })
      target.refresh("https://portrait.gitee.com/uploads/avatars/user/1800/5400665_CcSimple_1591166830.png!avatar200", {
        // auto: true, // 根据图片宽高自动等比(宽>高?width:height)
        // width: true, // 按宽调整高
        // height: true, // 按高调整宽
        real: true // 根据图片实际尺寸调整(转pt)
      })
    }, 3000)
  }
})
2. ✨ 调整优化 页脚线/页眉线时相互超过时 进行偏移处理
3. ✨ 调整优化 页眉/页脚过近,表格分页卡死情况(无法正常分页计算)
4. 🐛 fix 表格分页高度问题(未计算表格脚高度)
5. 🐛 fix 表格脚"最后显示"及"底部聚合类型"问题
6. 🐛 fix 表格头仅首页显示/不显示时 列宽拖拽调整问题

0.0.28 (2022-08-08)

1. 🐛 socket.io-client 更新到 4.x
2. 🐛 fix 打印预览(getHtml) 页码可拖拽问题
3. 🐛 fix 模板不分页时, table design时模板高度问题
4. 🐛 fix 分页后辅助元素错位问题
5. 🐛 fix getJson 隐藏列未返回问题
6. 🐛 fix 表格脚函数'最后显示'无效问题
7. ✨ 调整优化 样式引入问题(当没有print-lock.css情况现默认空样式)
8. ✨ 调整优化 页眉线问题(小于0时分页显示问题)
9. 🐛 fix 新插入列,选择字段后,'列属性' 空白问题

0.0.26 (2022-07-07)

1. 🌈 新增支持参数面板tabs分组(默认已分组支持自定义分组)
hiprint.setConfig({
  text: {
    tabs: [
      // 隐藏部分 (根据已有分组顺序来)
      {
        name: '测试', options: [
          {
            name: 'title',
            hidden: false
          },
          {
            name: 'field',
            hidden: true
          },
        ]
      },
    ],
  },
  image: {
    tabs: [
      {
        // 整体替换 及当前选项卡 按新参数设定
        replace: true,
        name: '基本', options: [
          {
            name: 'field',
            hidden: false
          },
          {
            name: 'src',
            hidden: false
          },
          {
            name: 'fit',
            hidden: false
          }
        ]
      },
    ],
  }
});
2. 🌈 新增支持拖拽元素 "吸附 / 对齐" 功能
3. 🌈 新增Api获取选中元素 "getSelectEls" (框选/按住ctrl/command多选)
// 单选时 返回 [e]
let els = hiprintTemplate.getSelectEls();
console.log(els)
4. 🌈 新增Api更新选中元素参数 "updateOption"
// 更新当前选中元素字体为 12pt
hiprintTemplate.updateOption('fontSize', 12);
// 更新当前选中元素字体粗细为 bolder
hiprintTemplate.updateOption('fontWeight', 'bolder');
5. 🌈 新增Api IPP打印(需客户端1.0.4及以上) "ippPrint","ippRequest"
/**
 * 通过IPP 可以调用打印机所提供的功能
 * 如:创建打印任务,取消打印任务,通过uri打印文档等等 (需要打印机支持)
 * 详见 IPP: https://github.com/williamkapke/ipp
 */
// 不知道打印机 ipp 情况, 可通过 '客户端' 获取一下
const printerList = hiprintTemplate.getPrinterList();
console.log(printerList)
if (!printerList.length) return;
let p = printerList[0];
console.log(p)
// 系统不同, 参数可能不同
let url = p.options['printer-uri-supported'];
// 测试 打印文本
hiprint.ippPrint({
  url: url,
  // 打印机参数: {version,uri,charset,language}
  opt: {},
  action: 'Print-Job',
  // ipp参数
  message: {
    "operation-attributes-tag": {
      "requesting-user-name": "hiPrint", // 用户名
      "job-name": "ipp Test Job", // 任务名
      "document-format": "text/plain" // 文档类型
    },
    // data 需为 Buffer (客户端简单处理了string 转 Buffer), 支持设置 encoding
    // data 需为 Buffer (客户端简单处理了string 转 Buffer), 支持设置 encoding
    // data 需为 Buffer (客户端简单处理了string 转 Buffer), 支持设置 encoding
    // 其他 Uint8Array/ArrayBuffer   默认仅 使用 Buffer.from(data)
    // 其他 Uint8Array/ArrayBuffer   默认仅 使用 Buffer.from(data)
    // 其他 Uint8Array/ArrayBuffer   默认仅 使用 Buffer.from(data)
    // 其他 Uint8Array/ArrayBuffer   默认仅 使用 Buffer.from(data)
    data: 'test test test test test test test',
    encoding: 'utf-8' // 默认可不传
  }
}, (res) => {
  // 执行的ipp 任务回调 / 错误回调
  console.log(res)
}, (printer) => {
  // ipp连接成功 回调 打印机信息
  console.log(printer)
})
6. ✨ 调整优化"拖动方向"功能, 支持按住shift 横向拖动, shift+alt 竖向拖动
7. 🌈 新增支持添加自定义/重写参数 通过setConfig
hiprint.setConfig({
  optionItems: [
    // 自定义添加一个scale参数  (重写及定义一个已存在的name)
    function () {
      function t() {
        // json模板 options 对应键值
        this.name = "scale";
      }
      return t.prototype.css = function (t, e) { // t: 元素对象, e 参数值
        if (t && t.length) {
          if (e) return t.css('transform', 'scale(' + e + ')');
        }
        return null;
      }, t.prototype.createTarget = function (t,i,e) { //  t: 元素对象,i: 元素options, e: 元素printElementType
        return this.target = $('<div class="hiprint-option-item">\n        <div class="hiprint-option-item-label">\n        缩放\n        </div>\n        <div class="hiprint-option-item-field">\n        <input type="number" class="auto-submit"/>\n        </div>\n    </div>'), this.target;
      }, t.prototype.getValue = function () {
        var t = this.target.find("input").val();
        if (t) return parseFloat(t.toString());
      }, t.prototype.setValue = function (t) { //  t: options 对应键的值
        this.target.find("input").val(t);
      }, t.prototype.destroy = function () {
        this.target.remove();
      }, t;
    }(),
  ],
  // 添加到 样式 tab 下的 transform 后面
  text: {
    tabs: [
      {
        name: '基础', options: []
      },
      {
        name: '样式', options: [
          {
            name: 'scale',
            after: 'transform', // 自定义参数,插入在 transform 之后
            hidden: false
          },
        ]
      }
    ]
  }
})
8. 🌈 新增支持 二维码 "容错率" 参数 {L:1, M:0, Q:3, H:2}
// json模板中配置
options: {
  qrcodeLevel: 1 // {L:1, M:0, Q:3, H:2}
}
8. 🐛 一些问题的修复及调整
1. fix 不显示表头时,样式问题
2. fix 元素参数(字体、字间距)对宽高大小框的影响
3. fix printerList、address 回调越来越多的问题
4. fix printSuccess、printError 回调越来越多的问题
5. fix 多选元素 拖拽 辅助线 问题
6. 调整优化 宽高大小/坐标位置 样式 (居中)
7. fix 表格列排序样式问题
8. fix 部分参数设置未及时生效问题(左/右/下边框;上/下/右内边距)

0.0.24 (2022-06-26)

1. 🌈 新增支持设置字体列表fontList
hiprintTemplate = new hiprint.PrintTemplate({
  ...,
  // 自定义可选字体(本机已安装字体)
  // 或者使用 hiprintTemplate.setFontList([])
  // 或元素中 options.fontList: []
  fontList: [
    {title:'微软雅黑',value:'Microsoft YaHei'},
    {title:'黑体',value:'STHeitiSC-Light'},
    {title:'思源黑体',value:'SourceHanSansCN-Normal'},
    {title:'王羲之书法体',value:'王羲之书法体'},
    {title:'宋体',value:'SimSun'},
    {title:'华为楷体',value:'STKaiti'},
    {title:'cursive',value:'cursive'},
  ],
2. ✨ 调整优化横/竖线参数,虚线->长虚线、短虚线
详见参数配置
3. 🐛 fix元素多时卡机的问题(hinnn.event导致)
元素多卡顿问题(hinnn.event导致)
4. ✨ 调整优化部分样式问题,并支持重写(辅助线,始终隐藏元素)样式
始终隐藏元素 重写 .alwaysHide css

position/size-box的样式(层级及元素行高影响问题)

/* 拖拽时元素辅助线 */
.toplineOfPosition, .bottomlineOfPosition {
  border: 0;
  border-top: 1px dashed  rgb(169, 169, 169);
}
.leftlineOfPosition, .rightlineOfPosition {
  border: 0;
  border-left: 1px dashed  rgb(169, 169, 169);
}
5. 🐛 ️fix优化表格列显示隐藏/列排序相关问题

6. ✨ 调整优化列选择/列宽调整的问题

7. 🌈 新增支持设置面板参数显示/隐藏
hiprint.setConfig({
  movingDistance: 2.5,
  panel: {
    supportOptions: [
      {
        name: 'firstPaperFooter', // 隐藏 首页页尾
        hidden: true
      },
      {
        name: 'evenPaperFooter', // 隐藏 偶数页页尾
        hidden: true
      },
    ]
  }
})

0.0.23 (2022-06-15)

1. 新增支持不打印功能
设置元素 options.showInPage: 'none' 打印时不打印
或在右侧参数 '显示规则' 下列选择 '始终隐藏'
2. 新增刷新获取打印机列表api
// 连接上客户端时 获取最新打印机列表
hiprint.refreshPrinterList((list)=>{
  console.log(list)
})
3. 新增获取IP、IPv6、MAC的api
// 连接上客户端时 获取MAC地址等
/**
 * 参数格式:
 * 1. 类型(ip、ipv6、mac、dns、all、interface、vboxnet)
 * 2. 回调 data => {addr, e}  addr: 返回的数据 e:错误信息
 * 3. 其他参数 ...args
 */
hiprint.getAddress('mac',(data)=>{
  console.log('mac')
  console.log(data)
})
4. 新增支持设置元素层级
options.zIndex: 10 调整元素层级
或在右侧参数 '元素层级' 中输入 10
5. 调整优化元素设置fields问题
(原无法返回此fields列表,且需设置在元素的printElementType中)
设置元素字段名 options.fields: [{"text":'id',"field":'id']
字段名将变成下列选择样式, getJson() 将返回此列表
6. 新增支持图片地址选择按钮
hiprintTemplate = new hiprint.PrintTemplate({
  template: panel,
  // 图片选择功能
  onImageChooseClick: (target) => {
    // target.getValue()
    // 测试 3秒后修改图片地址值
    setTimeout(()=>{
      target.refresh("url")
    },3000)
  },
  settingContainer: '#PrintElementOptionSetting',
});
7. 新增支持图片元素设置缩放格式fit
图片元素设置 options.bject-fix: fill|contain|cover|none
或右侧参数 '图片缩放' 下拉选择
8. 调整优化控制点等比缩放功能
text元素修改为barcode/qrcode时调整控制按钮
右下控制点拖动时等比缩放, 按住shift时可自由缩放
9. 调整优化元素框选功能
从右侧参数栏快速从右往左选择时鼠标移动到design内时框选框的大小问题
JavaScript
1
https://gitee.com/kaisr/vue-plugin-hiprint.git
git@gitee.com:kaisr/vue-plugin-hiprint.git
kaisr
vue-plugin-hiprint
vue-plugin-hiprint
main

搜索帮助