更新时间:2021-11-15 22:39:42
应用程序接口
var canvas = document.querySelector("canvas");
var signaturePad = new SignaturePad(canvas);
//将签名图像作为数据 URL 返回(有关可能的参数列表,请参阅https://mdn.io/todataurl)
signaturePad.toDataURL(); // 将图像另存为 PNG
signaturePad.toDataURL("image/jpeg"); //将图像另存为 JPEG
signaturePad.toDataURL("image/svg+xml"); //将图像另存为 SVG
//从数据 URL 中绘制签名图像。
//注意:此方法不会填充表示绘制签名的内部数据结构。 因此,使用#fromDataURL 后,#toData 将无法正常工作。
signaturePad.fromDataURL("data:image/png;base64,iVBORw0K...");
//以点组数组的形式返回签名图像
const data = signaturePad.toData();
//从一组点组中绘制签名图像
signaturePad.fromData(data);
//清除画布
signaturePad.clear();
//如果画布为空则返回真,否则返回假
signaturePad.isEmpty();
//解除所有事件处理程序的绑定
signaturePad.off();
//重新绑定所有事件处理程序
signaturePad.on();dotSize
(浮点数或函数)单个点的半径。
minWidth
(float) 线的最小宽度。默认为 0.5。
maxWidth
(float) 线的最大宽度。默认为 2.5。
throttle
(整数)每 x 毫秒最多绘制下一个点。将其设置为 0 以关闭节流。默认为 16。
minDistance
(整数)仅当前一个点远于 x 像素时才添加下一个点。默认为 5。
backgroundColor
(字符串)用于清除背景的颜色。可以是 context.fillStyle 接受的任何颜色格式。默认为“rgba(0,0,0,0)”(透明黑色)。使用不透明的颜色,例如“rgb(255,255,255)”(不透明白色)如果您想将签名保存为 JPEG 图像。
penColor
(字符串)用于绘制线条的颜色。可以是 context.fillStyle 接受的任何颜色格式。默认为“黑色”。
velocityFilterWeight
(float) 用于根据先前速度修改新速度的权重。默认为 0.7。
onBegin
(功能)笔画开始时的回调。
onEnd
(function) 行程结束时回调。
您可以在初始化期间设置选项:
var signaturePad = new SignaturePad(canvas, {
minWidth: 5,
maxWidth: 10,
penColor: "rgb(66, 133, 244)"
});或在运行时:
var signaturePad = new SignaturePad(canvas); signaturePad.minWidth = 5; signaturePad.maxWidth = 10; signaturePad.penColor = "rgb(66, 133, 244)";
处理高 DPI 屏幕
要在低 DPI 和高 DPI 屏幕上正确处理画布,必须考虑 devicePixelRatio 并相应地缩放画布。这种缩放对于正确显示通过 SignaturePad#fromDataURL 加载的签名也是必要的。
这是一个如何完成的示例:
function resizeCanvas() {
var ratio = Math.max(window.devicePixelRatio || 1, 1);
canvas.width = canvas.offsetWidth * ratio;
canvas.height = canvas.offsetHeight * ratio;
canvas.getContext("2d").scale(ratio, ratio);
signaturePad.clear(); // otherwise isEmpty() might return incorrect value
}
window.addEventListener("resize", resizeCanvas);
resizeCanvas();