电子签名（扩展）

用于在业务系统中采集、展示和保存用户签名信息。基于文本框编辑器进行扩展，编辑器样式代码名称为：SIGNATURE

示例效果

输入参数

名称	说明	类型	默认值
value	编辑器值	[String, Number]	-
controller	编辑器控制器对象	new RequiredProp(Object as PropType<C>)	-
data	容器数据，通常为表单数据，表格行数据，面板数据	new RequiredProp(Object as PropType<IData>)	-
disabled	是否禁用	{ type: Boolean }	false
readonly	是否只读	{ type: Boolean, default: false }	false
controlParams	容器控件参数，一般是指表单部件控件参数、表格控件参数、面板控件参数	{ type: Object, required: false }	-

事件

名称	说明	类型
change	值变更事件	{_value:V, _name?:string, _ignore?:boolean}

编辑器参数

名称	说明	类型	默认值
mode	指定签名的保存格式。当值为'img'时，直接保存为Base64格式的图片URL（以data:协议开头）；当值为'file'时，系统会先将签名图片上传至服务器，再保存服务器返回的文件元信息（包含文件ID和名称）	'img' | 'file'	'img'
buttons	配置签名的操作按钮。JSON 字符串数组中每个对象表示一个按钮：label为按钮显示文本；type为按钮触发的事件类型（undo-撤销上一步，rewrite-清空重写，confirm-确认保存）；buttonType可选，指定按钮样式（支持primary/success/default/danger/warning）。示例：仅显示确认按钮可配置为[{"label":"确认","type":"confirm","buttonType":"primary"}]	string	'[{"label":"撤销","type":"undo"},{"label":"重写","type":"rewrite"},{"label":"确认","type":"confirm","buttonType":"primary"}]'
dotsize	点的大小（单位：像素）。控制点击画布时生成的点的尺寸，0表示根据线条宽度自动计算点的大小	number	0
minwidth	线条最小宽度（单位：像素）。控制签名线条的最细宽度，绘制速度越快，线条越接近此值	number	2
maxwidth	线条最大宽度（单位：像素）。控制签名线条的最粗宽度，绘制速度越慢，线条越接近此值	number	2
pencolor	画笔颜色。签名轨迹的颜色，可接受CSS颜色格式（如#ff0000）	string	'black'
velocityfilterweight	线条粗细速度敏感度。用于平滑处理绘制速度的计算，影响线条粗细随速度的变化幅度。值越接近1，当前速度对线条粗细影响越大；值越小，线条过渡越平滑	number	0.7
mindistance	绘制点最小记录间距（单位：像素）。当点击画布生成的点与后续绘制线的距离小于此值时，不记录后续绘制的线，用于减少冗余数据并优化绘制流畅度	number	5
backgroundcolor	画布背景色。签名画布的背景颜色，导出图片时会包含此背景，可接受CSS颜色格式	string	'rgba(0,0,0,0)'
throttle	事件节流时间（单位：毫秒）。限制绘制事件的触发频率，避免高频操作导致性能问题	number	16
readonly	设置编辑器是否为只读态	boolean	false
appentitytag	在应用启用下载授权时，用于指定当前文件所属实体。该参数值会作为验证下载权限的依据。配置格式为（应用代码名称.实体代码名称），示例：web.master	string	undefined
datafieldtag	在应用启用下载授权时，用于指定当前文件所关联的数据属性。完成配置后，将自动从容器数据（涵盖表单数据、表格行数据、面板数据）、上下文环境以及视图参数中获取该属性的实际值，将其作为验证下载权限的依据	string	undefined