更新日志

2.0.0

🚀 Features

• 实现画布内元素的二次编辑能力，已绘制的矩形、圆形、箭头、画笔、文本等元素可以再次选中、移动、删除，并纳入统一的撤销重绘流程
• 文本工具支持绘制后的重新编辑，优化文本插入、拖拽、快捷键确认/取消等交互细节
• 扩展 getCanvasElementsPosition 和 canvasElements，支持将画布内元素位置信息导出后再次回填渲染
• 自定义工具绘制内容可以通过 customElementApi 和 customElementAdapters 接入插件内部的可编辑逻辑，支持自定义元素选中、命中判断、拖拽移动和重绘
• 同步扩展 getCutBoxInfo，用于获取当前裁剪框位置信息

Refactor

• 对插件核心代码做了一整套模块化重构，将截图加载、画布事件、裁剪框交互、工具栏行为、DOM 管理、状态存储、类型声明等逻辑按职责拆分
• 引入更清晰的 Store 分层管理内部状态，减少入口文件中的状态堆叠，使绘制、编辑、撤销、重绘等流程更容易维护
• 整理常量、类型、工具方法和绘制方法的目录结构，降低模块之间的耦合关系
• 切换包管理工具到 pnpm，并优化 Rollup 构建流程和终端输出效果
• 补充核心交互、画布元素编辑、状态管理、工具栏同步等模块的单元测试，为后续功能迭代提供更稳定的回归保障

🐞 Bug Fixes

• 修复拖拽已有画布元素后，再次绘制新元素时旧元素选中态未被清理的问题
• 修复选中元素后拖拽其他元素，拖拽结束后未正确切换选中元素的问题
• 修复自定义元素选中时仍展示画笔大小、颜色、文字字号等内置工具选项面板的问题
• 修复工具栏、选项面板、颜色面板和文字大小面板在屏幕边缘可能溢出或被遮挡的问题
• 修复页面缩放后，单击截全屏时裁剪区域尺寸异常的问题
• 修复 Electron 全屏场景下工具栏可能被 Mac 菜单栏覆盖的问题

1.9.9-rc.28

🚀 Features

• 自定义工具栏点击回调事件添加图像信息的回传
• 扩展新的API：获取裁剪框位置信息

🐞 Bug Fixes

• 自定义的工具栏项点击回调的数据类型缺失问题

1.9.9-rc.27

🐞 Bug Fixes

• 当electron是全屏的时候，工具组件被Mac上面的标题栏给覆盖掉问题

1.9.9-rc.26

🐞 Bug Fixes

• 文本输入工具在页面有滚动条的情况下位置异常问题

1.9.9-rc.25

🐞 Bug Fixes

• 修复在高分屏上使用imgSrc参数自定义截图内容时出现的模糊问题。

1.9.9-rc.24

🚀 Features

• html2canvas截图模式扩展h2cIgnoreElementsCallback回调，用于截图时需要隐藏某些dom的场景

1.9.9-rc.23

🚀 Features

• 实现工具栏的模块化扩展功能

1.9.9-rc.22

🚀 Features

• html2canvas截图模式扩展h2cImgLoadErrCallback回调，用于处理跨域图片加载失败的场景。

1.9.9-rc.21

🚀 Features

• 自定义截图内容的时候拓展尺寸自定义功能

1.9.9-rc.20

🚀 Features

• 扩展destroyContainer参数，用于自定义截图容器的销毁行为

1.9.9-rc.19

🚀 Features

• html2canvas截图模式扩展useCORS参数

1.9.9-rc.18

🐞 Bug Fixes

• 修复chrome模拟移动端设备时截取不生效问题

1.9.9-rc.17

🐞 Bug Fixes

• 修复裁剪框无法多次重新绘制问题

1.9.9-rc.16

🐞 Bug Fixes

• 修复windows触屏设备无法使用问题

1.9.9-rc.15

🚀 Features

• 扩展saveImgTitle参数用以自定义图片保存时的名称

1.9.9-rc.14

🐞 Bug Fixes

• 修复等比例箭头参数是必填项问题

1.9.9-rc.13

🐞 Bug Fixes

• 马赛克第一次绘制时无法还原画布状态问题

1.9.9-rc.12

🐞 Bug Fixes

• 修复了文本中包含换行符时，渲染出来的内容未换行问题

1.9.9-rc.11

🐞 Bug Fixes

• 修复使用imgSrc传入图片高分屏下图片显示小的问题

1.9.9-rc.10

🐞 Bug Fixes

• 修复马赛克内容无法存储问题

1.9.9-rc.9

🚀 Features

• 拓展图片自适应参数

1.9.9-rc.8

🚀 Features

• 字体工具添加大小选择功能

1.9.9-rc.7

🚀 Features

• 扩展等比例箭头是否启用参数

1.9.9-rc.6

🚀 Features

• 扩展最大可撤销次数参数

🐞 Bug Fixes

• 修复单击截全屏参数不生效问题

1.9.9-rc.5

🐞 Bug Fixes

• 优化裁剪框最小尺寸计算策略

1.9.9-rc.4

🐞 Bug Fixes

• 修复Firefox浏览器因TouchEvent不存在而引发的无法运行问题

1.9.9-rc.3

🐞 Bug Fixes

• 修复webrtc模式截屏时出现鼠标指针问题

1.9.9-rc.2

🐞 Bug Fixes

• 修复打包出错引发的包体积过大问题

1.9.9

🚀 Features

• 截图保存时扩展相应的回调函数
• 截图确认按钮回调函数的返回值添加裁剪框信息
• 对触屏设备做兼容处理

🐞 Bug Fixes

• 解决文本输入工具绑定的快捷键不生效问题
• 修复构建后的*.d.ts文件的路径别名未正确转换问题
• 修复调用者传入position参数时所引发的工具栏偏移问题
• 修复裁剪框尺寸为最小时引发的崩溃问题
• 修复颜色选择下拉框点击页面空白处无法关闭问题
• 修复马赛克触笔大小影响到其他工具的画笔大小问题

1.9.8-rc.3

🚀 Features

• 截图确认按钮回调函数的返回值添加裁剪框信息

Breaking changes

• completeScreenshot 回调函数修改了返回值，新的返回值如下所示：

{
  "base64": "",
  "cutInfo": {
    "startX": "",
    "startY": "",
    "width": "",
    "height": ""
  }
}

1.9.8-rc.2

🚀 Features

• 截图保存时扩展相应的回调函数

1.9.8-rc.1

🐞 Bug Fixes

• 解决文本输入工具绑定的快捷键不生效问题

1.9.8

🚀 Features

• 允许调用者通过方法调用来获取裁剪区域的图片内容
• 允许调用者自定义裁剪区域的边框像素点颜色
• 文档中添加http环境下使用webrtc的方法

🐞 Bug Fixes

• 修复页面未点击时，通过esc快捷键无法响应问题
• 修复html2canvas模式截取下页面内容会出现挤压问题
• 修复调用者传入自定义dom时绘制内容会出现内容拉伸问题

1.9.7

🐞 Bug Fixes

• 修复层级调整参数无效问题

1.9.6

🐞 Bug Fixes

• 修复箭头绘制的尺寸无法控制问题

1.9.5

🐞 Bug Fixes

• 修复文字可以在裁剪框区域外绘制问题

1.9.4

🚀 Features

• webrtc截图添加窗口截取模式和隐藏滚动条选项
• webrtc截图实现从窗口流中截取body数据
• 截图内容是否写入剪切板支持自定义

1.9.3

🚀 Features

• 实现递增变粗箭头的绘制
• webrtc模式截图时支持传入参数对屏幕流进行裁剪
• webrtc模式截图失败时将错误信息返回给调用者

1.9.2

🚀 Features

• webrtc模式下给triggerCallback回调函数的返回值添加当前选择的标签页label

1.9.1

🚀 Features

• 扩展toolPosition参数用于自定义工具栏展示的位置
• 工具栏图标支持除关闭外的所有图标
• webrtc模式下给triggerCallback回调函数的返回值添加当前选择的窗口类型

1.9.0

🐞 Bug Fixes

• 修复打包后的代码未转换成es5问题

1.8.9

🐞 Bug Fixes

• 修复裁剪框在移动过程中会超出可视区域问题
• 修复工具栏某些情况下会超出右侧可视区域问题
• 修复插件集成到有自定义字体的项目时文字位置渲染出错问题
• 优化裁剪框区域超过顶部时的工具栏展示位置
• 修复单击截全屏功能启用时工具栏没有默认展示问题

1.8.8

🐞 Bug Fixes

• 修复声明文件找不到问题
• 修复工具栏某些情况下会超出左侧可视区域问题

1.8.7

🚀 Features

• 添加文本处于输入状态时点击工具栏的其他功能将其渲染至画布上功能
• 为文本输入框绑定快捷键
• 添加proxyUrl参数用来配置代理服务器 🐞 Bug Fixes
• 修复文本的渲染位置与输入时不一致问题

1.8.6

🚀 Features

• 添加对electron环境下使用webrtc模式进行截图的兼容处理 🐞 Bug Fixes
• 修复裁剪框生成后，在裁剪框之外单击出现工具栏位置渲染错误问题
• 修复高分屏下框选区域过低工具栏超出屏幕问题
• 优化截图时容器的默认宽高读取方式

1.8.2

🚀 Features

• 添加主动销毁截图容器方法
• 提升webrtc模式下图像展示效果
• 可选参数添加maskColor属性用于自定义蒙层的颜色

1.7.8

🚀 Features

• webrtc模式截屏时添加分享按钮的点击回调事件

🐞 Bug Fixes

• 修复高分屏下马赛克工具无法绘制问题
• 修复高分屏下保存图片比例错误问题
• 修复webrtc模式截图模糊问题
• 修复h2c模式截图在高分屏上的模糊问题

1.7.5

🚀 Features

• 扩展noScroll参数用来禁止截图容器滚动
• 扩展wrcReplyTime参数用来自定义webrtc弹窗的响应时间
• 截图时增加锁屏模式

🐞 Bug Fixes

• 修复单击截全屏时截图工具栏丢失问题
• 修复webrtc模式截图时showScreenData参数不生效问题
• 修复遮罩图层未全屏覆盖的留白问题
• 修复页面滚动后截图没有截取到滚动后可视区的页面内容
• 修复矩形绘制引发的历史记录丢失问题

1.7.2

🐞 Bug Fixes

• 修复showScreenData与画布宽高不起作用问题

1.7.1

🐞 Bug Fixes

• 修复初始化的裁剪框无法进行操作问题

1.7.0

🚀 Features

• 扩展cropBoxInfo参数，实现裁剪框初始化
• 插件扩展screenShotDom参数，实现指定dom截取功能

🐞 Bug Fixes

• 修复容器宽高自定义时，蒙层未应用问题
• 修复截图工具栏在部份ui框架中高度显示异常问题
• 修复工具栏未进行拖拽绘制时，鼠标点击触发历史记录保存问题
• 修复文本框输入完成后无法取消问题

1.6.2

🚀 Features

• 添加参数以支持调用者传入截图内容（解决electron环境下截图不完美问题）
• html2canvas模式添加参数支持跨域资源的加载

🐞 Bug Fixes

• 优化底部绘制裁剪框时工具栏的位置到截图容器内部

1.6.1

🚀 Features

• 截图组件加载完毕后，扩展参数支持截图内容显示至canvas画布功能
• 裁剪框左上方新增框选区域面积展示

🐞 Bug Fixes

• 修复裁剪框尺寸展示容器层级未调整问题
• 修复文本输入框层级未调整问题
• 修复截图工具颜色选项dom层级错误问题

1.5.6

🚀 Features

• 截图工具栏新增快捷键监听（关闭、确认、撤销）
• 添加截图工具栏图标自定义隐藏功能
• 完成截图时，实现将截图写入剪切板功能
• 截图完成后，实现将图片自动添加至剪贴板中

🐞 Bug Fixes

• 修复启用单击截屏时工具栏位置错乱问题
• 单击截取全屏时，优化截图工具栏位置到截图容器内
• 修复工具栏层级调整未判空问题
• 修复工具栏层级隐藏问题

1.5.2

🐞 Bug Fixes

• 修复裁剪阶段鼠标点击其他位置鼠标位置未复原问题
• 修复截图插件未传参数时导致绘制内容无法保存问题

1.5.0

🚀 Features

• 添加可选参数支持单击截全屏功能
• 添加用户获取截图响应与取消分享回调函数的支持：
  • webrtc模式添加取消分享回调函数
  • html2canvas模式添加截图响应回调函数
• 添加可选参数position来动态调整截图容器位置

🐞 Bug Fixes

• 完美解决确认后的截图精度不准问题
• 截图区域工具栏首次点击时删除裁剪框的8个可操作点
• 优化成功、失败回调参数的存在判断
• 优化框选完成后鼠标点击其他位置截图工具栏闪烁问题
• 修复插件调用者可以在框选区域外绘制问题
• 修复框选完成后，鼠标点击其他位置截图工具栏跟着移动问题
• 暴露插件内部的canvas容器给调用者
• 修复调用者不传任何东西时的报错问题
• 修复浏览器出现滚动条时截图容器位置显示错误问题

1.2.0

🚀 Features

• 让工具栏位置始终保持在截屏位置下方
• 添加截图关闭回调函数的支持

🐞 Bug Fixes

• 修复边界情况问题以及改善精度
• 修复截屏右下往左上拉的情况下宽高未设置的问题

1.1.8

🚀 Features

• 添加canvasWidth参数和canvasHeight参数，用以支持用户自定义画布宽、高

🐞 Bug Fixes

• 修复截屏图片未使用用户所传宽高问题
• 解决event.path在火狐和Safari的兼容性问题

1.1.4

🐞 Bug Fixes

• 修复用户未授权时截图dom未销毁问题

1.1.2

🚀 Features

• 实现通过webrtc进行页面截图，并添加参数用来控制启用状态

🐞 Bug Fixes

• webrtc截图时，修改装载图片的容器宽高为屏幕宽高
• 修复截屏图片展示比例错误问题

1.0.0

🚀 Features

• 完成插件开发
• 使用html2canvas实现页面截图