开源推荐!一款开箱即用的电子签名组件
作者: 徐小夕
公众号: 趣谈前端
hello, 大家好, 我是徐夕, 今天又到了分享时间. 今天和大家分享一下我最近开源的 轻量级电子签名组件——react-sign2 .
我们可以使用它轻松的实现电子签名, 比如说常用的 合同签字 , 文稿签名 , 艺术签名 等, 并支持一键将签名保存. 基本使用
我们要想直接使用, 可以在 npm 上安装 react-sign2 :# 或者yarn add react-sign2 npm i react-sign2
然后一个简单的使用如下: import Sign from "react-sign2"; export default () => console.log(c)} />;
react-sign2 还提供了很多可定制的属性, 来方便使用者灵活定制电子签名, 以下是开放性属性介绍:
比如我可以调整线条的颜色:
调整线条宽度:
在具体使用的时候灵活配置即可, 我还提供了业务中经常用到的监听事件, 方便使用者灵活调用: onSave 保存时的回调onClear 当画布清空时的回调onDrawEnd 每次绘制结束时的回调实现思路
按照笔者之前的习惯, 在设计组件之前都会 先明确组件的设计需求 , 然后根据健壮组件的设计原则来落地组件, 这里给大家分享一下我总结的几条组件设计经验: 对组件进行严格的属性设计, 保证业务层能低成本使用组件, 并保持一定的可配性 组件内外部类型约定(ts规范), 并提供对逻辑的兼容性 可读性(代码格式统一清晰,注释完整,代码结构层次分明,编程范式使用得当) 可用性(代码功能完整,在不同场景都能很好兼容,业务逻辑覆盖率) 复用性(代码可以很好的被其他业务模块复用) 可维护性(代码易于维护和扩展,并有一定的向下/向上兼容性) 高性能(组件具有一定的性能, 如复杂场景的渲染, 计算等)
对于电子签名组件, 我们最小化的需求就是 能满足用户的线上签名, 并能保存签名数据 .
以上就是我们最小化的需求, 为了满足我总结的组件设计几大原则, 我们需要对组件进行近一步的需求分析: 签名的颜色 , 笔触的粗细 , 平滑度 , 支持自定义事件 等.
这些都是组件第一个阶段可以想到的配置点, 也是能应对第一阶段业务需求的功能, 所以有了第一版的组件需求设计:
接下来就需要用 typescript 来规范组件的输入和输出了. 具体定义如下:export interface IProp { /** * @description 画布宽度 * @default 400 */ width?: number; /** * @description 画布高度 * @default 200 */ height?: number; /** * @description 线宽 * @default 4 */ lineWidth?: number; /** * @description 线段颜色 * @default "red" */ strokeColor?: string; /** * @description 设置线条两端圆角 * @default "round" */ lineCap?: string; /** * @description 线条交汇处圆角 * @default "round" */ lineJoin?: string; /** * @description 画布背景颜色 * @default "transparent" */ bgColor?: string; /** * @description true */ showBtn?: boolean; /** * @description 当保存时的回调, blob为生成的图片bob * @default - */ onSave?: (blob: Blob) => void; /** * @description 当画布清空时的回调, 参数为画布的上下文对象,可以直接使用canvas的api * @default - */ onClear?: (canvasContext: CanvasRenderingContext2D) => void; /** * @description 当画布结束时的回调 * @default - */ onDrawEnd?: (canvas: HTMLCanvasElement) => void; }
接下来就到了我们具体的代码实现阶段. 由于电子签名的核心技术采用的是 canvas (虽然用dom 和svg 也可以实现), 所以无论你是用的react 还是vue3 , 或者似乎原生态javascript , 都能低成本的封装. 这里笔者采用全球程序员 最爱用的react 来实现.
以上是组件的基本属性定义和代码结构, 画图部分涉及到 canvas 的比较细节的部分, 如果大家对图形学感兴趣可以参考我的专栏:
100+前端几何学应用案例 100+前端几何学应用案例
具体实现的源码我已经上传到 github , 感兴趣的朋友大家可以参考一下, 有问题随时交流反馈.
大家如果想直接使用, 可以使用如下方式安装使用:
react-sign2 官方演示文档 扩展
这里给大家聊点题外话, 也是大家比较关注的话题——如何持续维护开源项目. 就拿本文中实现的 react-sign2 举例, 以上分享的只是组件的第一阶段实现, 为了让我们的开源组件能被更多的人使用, 我们必须与时俱进, 随着技术的发展持续迭代优化技术底层实现, 比如跨平台, 跨终端, 跨框架, 优化或者增加新功能:
这样我们的开源组件库才能覆盖更多场景, 被更多人使用.
所以, 开源的正确打开方式, 你学会了吗? 如果对上面的迭代方向感兴趣, 欢迎一起共建v3.0.0. 更多推荐Dooring低代码关于辅助设计的思考和实践
低代码平台组件间通信方案复盘
如何评价Dooring低代码/零代码搭建平台?