二維碼已經滲透到生活的每個角落——餐廳點餐、支付、活動報到、產品說明。本文介紹一個純前端的 jQuery 二維碼外掛 qrcode,在頁面中呼叫幾行就能把任意字串變成一張可掃描的圖。
qrcode 本質上是用 jQuery 做「圖形渲染」:把計算出的模組矩陣畫出來。它支援兩種輸出方式——canvas(HTML5)與 table。前者效能好、可以縮放不失真;後者相容舊版 IE,是它的主要存在意義。
專案源碼:https://github.com/jeromeetienne/jquery-qrcode
"canvas" 或 "table",預設 canvas。QRErrorCorrectLevel.H(最高,可耐 30% 汙損)。<script src="../Js/jquery-1.11.3.min.js"></script> <script src="../Js/jquery-qrcode-master/jquery.qrcode.min.js"></script>
<div id="code"></div>
<script>
// 傳入任意字串,預設用 Canvas 繪製
$('#code').qrcode('https://blog.csdn.net/u011127019');
</script>

<div id="code"></div>
<script>
$('#code').qrcode({
render: 'table',
width: 100,
height: 100,
text: 'https://blog.csdn.net/u011127019'
});
</script>
直接實測就會發現:內容含中文時,掃出來是亂碼。原因在于這個外掛採用 charCodeAt() 進行編碼轉換,而這個方法取到的是 Unicode 碼點,並非二維碼標準所期望的 UTF-8 位元序列。所以在生成之前,必須自己把字串轉成 UTF-8。
<div id="code"></div>
<script>
// 把字串轉成 UTF-8 位元組序列
function toUtf8(str) {
var out = "", i, len, c;
len = str.length;
for (i = 0; i < len; i++) {
c = str.charCodeAt(i);
if ((c >= 0x0001) && (c <= 0x007F)) {
out += str.charAt(i); // 1 位元組
} else if (c > 0x07FF) {
out += String.fromCharCode(0xE0 | ((c >> 12) & 0x0F)); // 3 位元組
out += String.fromCharCode(0x80 | ((c >> 6) & 0x3F));
out += String.fromCharCode(0x80 | ((c >> 0) & 0x3F));
} else {
out += String.fromCharCode(0xC0 | ((c >> 6) & 0x1F)); // 2 位元組
out += String.fromCharCode(0x80 | ((c >> 0) & 0x3F));
}
}
return out;
}
$('#code').qrcode({ text: toUtf8('我是tianma'), width: 150, height: 150 });
</script>
這段是標準的 UTF-8 編碼演算法:ASCII 直接沿用,其餘依碼點大小拆成 2 或 3 個位元組,並用 0xxxxxxx / 110xxxxx / 1110xxxx 的格式標記位元組數。
理論上你可以自訂前景色與背景色:
$('#code').qrcode({
text: toUtf8('我是tianma'),
width: 150, height: 150,
background: '#f00',
foreground: '#0f0'
});
但實務上微信、支付寶等主流掃描器對非黑白配色的識別率很差,很多時候直接判定為無效碼。所以除了品牌設計稿上展示,正式發佈的付款碼、活動碼請老實用黑白色,並保持足夠的對比度。
理論上二維碼可編碼很長的內容,但掃描端的解碼能力才是真正瓶頸。實際測試的大致界線:
$('#code').qrcode({
text: toUtf8('這是一段比較長的文字內容,用來測試掃描器的解碼上限。'),
width: 150, height: 150
});
超過這個量,圖形會變得過於密集,模組小到相機解析不出來。內容真的很長時,正確做法是二維碼只放一個短網址,詳細內容放在網頁上。
加上靜默區(quiet zone)。二維碼四周需要留白,否則掃描器無法定位邊界。把 background 設為白色並在容器外加一層 padding 是最簡單的做法。
不要讓它太小。螢幕上顯示 150px 勉強可用,若要被列印或長距離掃描,單邊建議至少 3 公分。
需要保存成圖片時用 canvas。table 模式沒辦法直接轉圖,canvas 則可以用 toDataURL() 存成 PNG:
var dataURL = $("#code canvas")[0].toDataURL("image/png");
最後提一句:如果專案不需要支援 IE8 以下的瀏覽器(現在幾乎都已經不需要了),直接用 qrcode.js 或 Node 端產生圖片會更省事,也不必自己處理 UTF-8 轉換這一段。