手寫 Canvas 繪圖時,光是「上一點座標 → 下一點座標 → 畫一條線」就要處理滑鼠狀態、座標換算、畫布偏移等一堆細節。若只是要讓使用者在畫布上簽名或塗鴉,jcanvas 這類 jQuery 外掛能把 drawLine、clearCanvas、getCanvasImage 都包成一行 API,省事不少。
mousedown/mousemove/mouseup 記錄是否正在作畫,並把每次移動畫成一段線。checkData() 追蹤作畫範圍的最大/最小值(maxX、maxY、minX、minY),可用於後續裁切或判斷是否有內容。clearCanvas() 重來一次。getCanvasImage('png') 取得圖片資料。<head>
<script src="jquery-1.9.1.js"></script>
<script src="jcanvas.min.js"></script>
<script>
var maxX = -1, maxY = -1;
var minX = 99999, minY = 99999;
// 記錄作畫範圍
function checkData(event) {
var x = event.pageX - $('canvas').offset().left;
var y = event.pageY - $('canvas').offset().top;
if (x > maxX) { maxX = x; } else if (x < minX) { minX = x; }
if (y > maxY) { maxY = y; } else if (y < minY) { minY = y; }
}
$(function () {
var obj = $('canvas');
var temp_e;
var temp_draw = false;
obj.on({
mousedown: function (e) {
temp_e = e;
temp_draw = true;
checkData(e);
},
mousemove: function (e) {
if (temp_draw) {
obj.drawLine({
strokeStyle: '#000',
strokeWidth: 3,
x1: temp_e.pageX - $('canvas').offset().left,
y1: temp_e.pageY - $('canvas').offset().top,
x2: e.pageX - $('canvas').offset().left,
y2: e.pageY - $('canvas').offset().top
});
}
temp_e = e;
checkData(e);
},
mouseup: function (e) {
temp_e = null;
temp_draw = false;
checkData(e);
},
mouseout: function () {
temp_e = null;
temp_draw = false;
}
});
$('#clean').on('click', function () {
maxX = -1; maxY = -1;
minX = 99999; minY = 99999;
obj.clearCanvas();
});
$('#save').on('click', function () {
var image = obj.getCanvasImage('png');
alert(image);
});
});
</script>
</head>
<body>
<input type="button" id="save" value="保存" />
<input type="button" id="clean" value="清除" />
<br/>
<canvas width="320" height="480" style="background:#f00"></canvas>
<div id="points"></div>
</body>
getCanvasImage('png') 回傳的是 data:image/png;base64,... 形式的字串。範例只用 alert 把它印出來,實務上有三種常見去向:
// 1. 直接觸發下載
$('#save').on('click', function () {
var src = obj.getCanvasImage('png')
.replace('image/png', 'image/octet-stream');
var a = document.createElement('a');
a.href = src;
a.download = 'drawing.png';
a.click();
});
// 2. 塞進表單欄位,POST 回伺服器存檔
// <input type="hidden" name="imageData" id="imageData">
$('#imageData').val(obj.getCanvasImage('png'));
// 3. 直接放進 img 預覽
$('#preview').attr('src', obj.getCanvasImage('png'));
行動裝置:範例只綁了 mouse 事件,手機與平板上完全不會作畫。若要在觸控裝置使用,必須另外綁定 touchstart/touchmove/touchend,並從 e.touches[0] 取座標,同時呼叫 preventDefault() 避免頁面被滾動。
高解析度:Canvas 在 Retina 螢幕上會顯得模糊,因為一像素的 CSS 尺寸只對應一個實際像素。把 canvas.width 設為顯示寬度的 2 倍,再用 CSS 把寬高縮回來,線條就會銳利很多(記得同步把繪圖座標乘以 2)。