QR Code 已經滲透到日常生活的每個角落——掃一下就能加好友、看菜單、付款、看電影資訊。如果要在自己的網站上動態產生 QR Code(例如把當前網址、訂單編號或產品序號變成一張可掃描的圖),jQuery 的 qrcode 外掛是最省事的選擇。
它的原理是用 jQuery 進行圖形渲染,支援 canvas(HTML5)與 table 兩種繪製方式。專案原始碼可至 https://github.com/jeromeetienne/jquery-qrcode 取得。
1. 引入 jQuery 與 qrcode 外掛
<script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="jquery.qrcode.min.js"></script>
2. 在頁面中放一個容器
<div id="code"></div>
3. 呼叫外掛
最簡短的寫法,直接傳入字串:
$('#code').qrcode("https://hovertree.com"); // 可傳入任意字串
需要調整參數時,改用物件形式:
$("#code").qrcode({
render: "table", // 渲染方式:table 或 canvas
width: 200, // 寬度(px)
height: 200, // 高度(px)
text: "hovertree.com" // 要編碼的內容
});
預設使用 canvas 渲染,效率最高,但需要瀏覽器支援 HTML5;若需相容舊版瀏覽器,把 render 改成 "table" 即可,用一堆 table 格子拼出圖案。完成後,用手机「掃一掃」就能讀取內容。
實測時會發現,含中文的字串產生的 QR Code 無法正確識別。原因是 jquery-qrcode 採用 charCodeAt() 進行編碼轉換,而這個方法取得的是 Unicode 碼點;QR Code 需要 UTF-8 位元組流,中文(碼點大於 0x7FF)會佔用多個位元組,直接編碼就會出錯。
解法是在生成 QR Code 之前,先把字串轉成 UTF-8 位元組序列:
function toUtf8(str) {
var out, i, len, c;
out = "";
len = str.length;
for (i = 0; i < len; i++) {
c = str.charCodeAt(i);
if ((c >= 0x0001) && (c <= 0x007F)) {
out += str.charAt(i);
} else if (c > 0x07FF) {
out += String.fromCharCode(0xE0 | ((c >> 12) & 0x0F));
out += String.fromCharCode(0x80 | ((c >> 6) & 0x3F));
out += String.fromCharCode(0x80 | ((c >> 0) & 0x3F));
} else {
out += String.fromCharCode(0xC0 | ((c >> 6) & 0x1F));
out += String.fromCharCode(0x80 | ((c >> 0) & 0x3F));
}
}
return out;
}
這個函式依碼點大小分三種情況處理:ASCII 範圍直接保留;大於 0x7FF 的字元(包含絕大多數 CJK 字)編碼為三個位元組;其餘編碼為兩個位元組。這正是 UTF-8 的變長編碼規則。
使用方式:
var str = toUtf8("歡迎光臨何問起!");
$('#code').qrcode(str);
順帶一提,現代瀏覽器已普遍支援 TextEncoder,若要處理更完整的 Unicode(含 emoji),改用 new TextEncoder().encode(str) 會比手寫位元運算更可靠。
尺寸要留白。QR Code 四周需要一塊空白(安靜區)才能被順利掃描,若把容器塞滿或加上邊框,辨識率會下降。
內容別塞太多。編碼的資料量越大,模組就越密、越難掃。盡量只放短網址或短編號,把詳細資訊留在後端。
慎選渲染方式。若 QR Code 需要放在可列印或可縮放的場景,table 或 SVG 会比 canvas 更清晰;純顯示用途則 canvas 效能較佳。