如何使用 JavaScript Canvas 构建签名板

签名板是 Web 表单、合同和电子签署工作流中用于采集数字签名的常见 UI 组件。Konva 可以轻松帮你构建一个签名板，支持平滑线条绘制、可自定义的笔设置，以及一键导出为 PNG。

说明： 请在下方绘制你的签名。使用控件更改笔颜色、清除签名板，或将签名保存/导出为 PNG 图像。

Vanilla

import Konva from 'konva';

// --- UI 控件 ---
const controls = document.createElement('div');
controls.style.cssText = 'display:flex;gap:8px;align-items:center;margin-bottom:4px;flex-wrap:wrap;';

const colorLabel = document.createElement('label');
colorLabel.textContent = '笔颜色：';
const colorInput = document.createElement('input');
colorInput.type = 'color';
colorInput.value = '#000000';
colorLabel.appendChild(colorInput);

const widthLabel = document.createElement('label');
widthLabel.textContent = '宽度：';
const widthSelect = document.createElement('select');
[2, 3, 4, 5, 6].forEach((w) => {
  const opt = document.createElement('option');
  opt.value = w;
  opt.textContent = w + 'px';
  if (w === 3) opt.selected = true;
  widthSelect.appendChild(opt);
});
widthLabel.appendChild(widthSelect);

const clearBtn = document.createElement('button');
clearBtn.textContent = '清除';
const saveBtn = document.createElement('button');
saveBtn.textContent = '另存为 PNG';

controls.appendChild(colorLabel);
controls.appendChild(widthLabel);
controls.appendChild(clearBtn);
controls.appendChild(saveBtn);
const container = document.getElementById('container');
container.parentNode.insertBefore(controls, container);

// --- 舞台设置 ---
const width = window.innerWidth;
const height = window.innerHeight - 40;

const stage = new Konva.Stage({
  container: 'container',
  width: width,
  height: height,
});

const bgLayer = new Konva.Layer();
stage.add(bgLayer);

// 底部签名线
const signLine = new Konva.Line({
  points: [40, height - 60, width - 40, height - 60],
  stroke: '#ccc',
  strokeWidth: 1,
  dash: [6, 4],
});
bgLayer.add(signLine);

const signLabel = new Konva.Text({
  x: 40,
  y: height - 50,
  text: '在此签名',
  fontSize: 14,
  fill: '#aaa',
  fontFamily: 'Arial',
});
bgLayer.add(signLabel);

const drawLayer = new Konva.Layer();
stage.add(drawLayer);

let isPaint = false;
let lastLine;
let lastPointerPosition;

stage.on('mousedown touchstart', function (e) {
  isPaint = true;
  lastPointerPosition = stage.getPointerPosition();
  lastLine = new Konva.Line({
    stroke: colorInput.value,
    strokeWidth: parseInt(widthSelect.value),
    lineCap: 'round',
    lineJoin: 'round',
    tension: 0.3,
    points: [lastPointerPosition.x, lastPointerPosition.y],
  });
  drawLayer.add(lastLine);
});

stage.on('mouseup touchend', function () {
  isPaint = false;
});

stage.on('mousemove touchmove', function (e) {
  if (!isPaint) return;
  e.evt.preventDefault();
  const pos = stage.getPointerPosition();
  const newPoints = lastLine.points().concat([pos.x, pos.y]);
  lastLine.points(newPoints);
  lastPointerPosition = pos;
});

clearBtn.addEventListener('click', function () {
  drawLayer.destroyChildren();
});

saveBtn.addEventListener('click', function () {
  // 为了干净导出，暂时隐藏背景元素
  bgLayer.hide();
  const dataURL = stage.toDataURL({ pixelRatio: 2 });
  bgLayer.show();

  const link = document.createElement('a');
  link.download = 'signature.png';
  link.href = dataURL;
  document.body.appendChild(link);
  link.click();
  document.body.removeChild(link);
});

React

import React from 'react';
import { Stage, Layer, Line, Text } from 'react-konva';

const App = () => {
  const [lines, setLines] = React.useState([]);
  const [color, setColor] = React.useState('#000000');
  const [strokeWidth, setStrokeWidth] = React.useState(3);
  const isDrawing = React.useRef(false);
  const stageRef = React.useRef(null);
  const bgLayerRef = React.useRef(null);

  const stageWidth = window.innerWidth;
  const stageHeight = window.innerHeight - 50;

  const handleMouseDown = (e) => {
    isDrawing.current = true;
    const pos = e.target.getStage().getPointerPosition();
    setLines([
      ...lines,
      { color, strokeWidth, points: [pos.x, pos.y] },
    ]);
  };

  const handleMouseMove = (e) => {
    if (!isDrawing.current) return;
    e.evt.preventDefault();
    const stage = e.target.getStage();
    const point = stage.getPointerPosition();
    const lastLine = lines[lines.length - 1];
    lastLine.points = lastLine.points.concat([point.x, point.y]);
    lines.splice(lines.length - 1, 1, lastLine);
    setLines(lines.concat());
  };

  const handleMouseUp = () => {
    isDrawing.current = false;
  };

  const handleClear = () => setLines([]);

  const handleSave = () => {
    const stage = stageRef.current;
    bgLayerRef.current.hide();
    const dataURL = stage.toDataURL({ pixelRatio: 2 });
    bgLayerRef.current.show();
    const link = document.createElement('a');
    link.download = 'signature.png';
    link.href = dataURL;
    document.body.appendChild(link);
    link.click();
    document.body.removeChild(link);
  };

  return (
    <>
      <div style={{ display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap', marginBottom: 4 }}>
        <label>
          笔颜色:{' '}
          <input
            type="color"
            value={color}
            onChange={(e) => setColor(e.target.value)}
          />
        </label>
        <label>
          宽度:{' '}
          <select
            value={strokeWidth}
            onChange={(e) => setStrokeWidth(Number(e.target.value))}
          >
            {[2, 3, 4, 5, 6].map((w) => (
              <option key={w} value={w}>{w}px</option>
            ))}
          </select>
        </label>
        <button onClick={handleClear}>清除</button>
        <button onClick={handleSave}>另存为 PNG</button>
      </div>
      <Stage
        ref={stageRef}
        width={stageWidth}
        height={stageHeight}
        onMouseDown={handleMouseDown}
        onMousemove={handleMouseMove}
        onMouseup={handleMouseUp}
        onTouchStart={handleMouseDown}
        onTouchMove={handleMouseMove}
        onTouchEnd={handleMouseUp}
      >
        <Layer ref={bgLayerRef}>
          <Line
            points={[40, stageHeight - 60, stageWidth - 40, stageHeight - 60]}
            stroke="#ccc"
            strokeWidth={1}
            dash={[6, 4]}
          />
          <Text
            x={40}
            y={stageHeight - 50}
            text="在此签名"
            fontSize={14}
            fill="#aaa"
            fontFamily="Arial"
          />
        </Layer>
        <Layer>
          {lines.map((line, i) => (
            <Line
              key={i}
              points={line.points}
              stroke={line.color}
              strokeWidth={line.strokeWidth}
              tension={0.3}
              lineCap="round"
              lineJoin="round"
            />
          ))}
        </Layer>
      </Stage>
    </>
  );
};

export default App;

Vue

<template>
  <div>
    <div style="display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin-bottom:4px">
      <label>
        笔颜色:
        <input type="color" v-model="color" />
      </label>
      <label>
        宽度:
        <select v-model.number="strokeWidth">
          <option v-for="w in [2,3,4,5,6]" :key="w" :value="w">{{ w }}px</option>
        </select>
      </label>
      <button @click="handleClear">清除</button>
      <button @click="handleSave">另存为 PNG</button>
    </div>
    <v-stage
      ref="stageRef"
      :config="stageConfig"
      @mousedown="handleMouseDown"
      @mousemove="handleMouseMove"
      @mouseup="handleMouseUp"
      @touchstart="handleMouseDown"
      @touchmove="handleMouseMove"
      @touchend="handleMouseUp"
    >
      <v-layer ref="bgLayerRef">
        <v-line :config="signLineConfig" />
        <v-text :config="signLabelConfig" />
      </v-layer>
      <v-layer>
        <v-line
          v-for="(line, i) in lines"
          :key="i"
          :config="{
            points: line.points,
            stroke: line.color,
            strokeWidth: line.strokeWidth,
            tension: 0.3,
            lineCap: 'round',
            lineJoin: 'round'
          }"
        />
      </v-layer>
    </v-stage>
  </div>
</template>

<script setup>
import { ref, computed } from 'vue';

const color = ref('#000000');
const strokeWidth = ref(3);
const lines = ref([]);
const isDrawing = ref(false);
const stageRef = ref(null);
const bgLayerRef = ref(null);

const stageWidth = window.innerWidth;
const stageHeight = window.innerHeight - 50;

const stageConfig = { width: stageWidth, height: stageHeight };
const signLineConfig = {
  points: [40, stageHeight - 60, stageWidth - 40, stageHeight - 60],
  stroke: '#ccc', strokeWidth: 1, dash: [6, 4]
};
const signLabelConfig = {
  x: 40, y: stageHeight - 50, text: '在此签名',
  fontSize: 14, fill: '#aaa', fontFamily: 'Arial'
};

const handleMouseDown = (e) => {
  isDrawing.value = true;
  const pos = e.target.getStage().getPointerPosition();
  lines.value.push({ color: color.value, strokeWidth: strokeWidth.value, points: [pos.x, pos.y] });
};

const handleMouseMove = (e) => {
  if (!isDrawing.value) return;
  e.evt.preventDefault();
  const point = e.target.getStage().getPointerPosition();
  const lastLine = lines.value[lines.value.length - 1];
  lastLine.points = lastLine.points.concat([point.x, point.y]);
  lines.value.splice(lines.value.length - 1, 1, { ...lastLine });
};

const handleMouseUp = () => { isDrawing.value = false; };

const handleClear = () => { lines.value = []; };

const handleSave = () => {
  const stage = stageRef.value.getNode();
  bgLayerRef.value.getNode().hide();
  const dataURL = stage.toDataURL({ pixelRatio: 2 });
  bgLayerRef.value.getNode().show();
  const link = document.createElement('a');
  link.download = 'signature.png';
  link.href = dataURL;
  document.body.appendChild(link);
  link.click();
  document.body.removeChild(link);
};
</script>