直接上程式碼。以下示範如何用 jquery.qrcode 這個小函式庫,在瀏覽器端把「名片資料」或「普通網址」即時轉成 QR Code,不需要經過伺服器。
先到 https://github.com/jeromeetienne/jquery-qrcode 下載 jquery.qrcode.min.js,並在頁面準備一個容器:
<div id="qrcodeid"></div> <script type="text/javascript" src="js/jquery.qrcode.min.js"></script>
QR Code 的標準編碼是 UTF-8,但 JavaScript 的字串是 UTF-16。直接塞中文進去,多數掃描器會解出亂碼。因此要先做一次 UTF-16 轉 UTF-8:
function utf16to8(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); // ASCII 原樣保留
} else if (c > 0x07FF){
out += String.fromCharCode(0xE0 | ((c >> 12) & 0x0F)); // 三 bytes
out += String.fromCharCode(0x80 | ((c >> 6) & 0x3F));
out += String.fromCharCode(0x80 | ((c >> 0) & 0x3F));
} else {
out += String.fromCharCode(0xC0 | ((c >> 6) & 0x1F)); // 兩 bytes
out += String.fromCharCode(0x80 | ((c >> 0) & 0x3F));
}
}
return out;
}
這段是手寫的 UTF-8 編碼器:單 bytes 直接放、雙 bytes 用 110xxxxx 10xxxxxx 的位元組前綴、三 bytes 用 1110xxxx 10xxxxxx 10xxxxxx。位元運算 >> 負責取值、& 負責截取、| 負責拼上標記位。今天的替代方案是 unescape(encodeURIComponent(str)) 或 TextEncoder,但理解這段有助於看懂編碼的實際運作。
名片用的是 vCard 格式,這是一套跨平台約定,掃描後手機通訊錄能直接辨識並新增聯絡人:
var the_text =
"BEGIN:VCARD \r\n" +
"FN:姓名 \r\n" +
"TEL;CELL,VOICE:15000000000 \r\n" +
"TITLE:職稱 \r\n" +
"ORG:公司(組織) \r\n" +
"EMAIL;INTERNET,HOME:123@qq.com \r\n" +
"ADR;WORK,POSTAL:地球中國山東... \r\n" +
"URL:https://leerd.cn \r\n" +
"END:VCARD";
the_text = utf16to8(the_text);
jQuery('#qrcodeid').qrcode({
width: 140,
height: 140,
render: "canvas", // 渲染方式:canvas 或 table
typeNumber: -1, // 計算模式,-1 代表自動決定版本
correctLevel: 0, // 糾錯等級
background: "#ffffff",
foreground: "#000000",
text: the_text
});
若只要產生普通網址 QR Code,把 text 換成網址字串即可,不必走 vCard 格式。
typeNumber: -1 表示自動計算,讓函式庫依內容長度選最小的 QR 版本,這是建議值。correctLevel 有四級:0 = L(約 7%)、1 = M(15%)、2 = Q(25%)、3 = H(30%)。等級越高越耐污損與摺痕,但格子會變密、可掃距離變短。名片這種要印在紙上的,建議用 2 或 3;純螢幕顯示用 0 或 1 就夠。
render 選 canvas 效能好、畫面細緻,選 table 則相容性較佳且可直接存成圖檔。若要在 Safari 舊版上跑,table 比較保險。
第一,內容越長,格子越密。vCard 塞太多欄位會讓 QR Code 密到掃不出來,建議精簡到必要欄位,並把 width 放大到 200px 以上。第二,中日韓文字建議改用 UTF-8 模式編碼,部分掃描器對 ECI 模式的支援不佳,手動轉 UTF-8 是最相容的做法。第三,產生後務必實測:至少用兩三種不同 App(手機相機、WeChat、iOS 內建)掃一次,並測試螢幕低亮度與列印成紙的效果。第四,若使用者輸入的內容會被放進 QR Code,記得先過濾換行符號,避免 vCard 結構被注入額外欄位。