行動裝置普及之後,QR Code 幾乎無所不在:菜單、票券、活動頁、名片,處處可見。想在自己的專案裡產生 QR Code,其實有不少路可走。這篇把原理與四種常見做法一起整理出來,方便依需求挑選。
二維條碼大致分成兩類。第一類是堆疊式(又稱行排式),外觀上就是把多列短的一維條碼上下堆疊起來;第二類是矩陣式,用方陣排列,在對應的格子裡以「點」代表二進位 1、以「空」代表二進位 0,靠點與空的排列組合來編碼。我們日常看到的 QR Code 屬於矩陣式。
深色模塊代表二進位 1,淺色模塊代表 0,這是解讀時最基本的約定。
QR Code 之所以好玩,是因為它內建了錯誤更正機制。即使部分區域被遮擋或污損,仍然有機會還原出正確內容。常見的四個等級如下:
正因如此,才有辦法在 QR Code 中央嵌入 logo、圖片或文字,甚至做成造型特殊的視覺設計——被遮掉的那一塊,解碼時能靠容錯機制補回來。等級越高,容錯越強,但可承載的資料量也會隨之下降,這中間需要取捨。
早期最省事的做法,是把參數拼進網址,讓服務端直接回傳一張圖片。
<?php
$urlToEncode = "https://www.example.com"; // 要編碼的網址
generateQRfromGoogle($urlToEncode);
function generateQRfromGoogle($chl, $widhtHeight = '150', $EC_level = 'L', $margin = '0')
{
echo '<img src="https://chart.apis.google.com/chart?chs=' . $widhtHeight . 'x' . $widhtHeight
. '&cht=qr&chld=' . $EC_level . '|' . $margin . '&chl=' . $chl
. '" alt="QR code" width="' . $widhtHeight . '" height="' . $widhtHeight . '" />';
}
?>
要提醒的是,這個服務早已停止對外提供,上面程式碼如今只能當作思路參考。另外原範例裡 urlencode($url) 的變數名稱與函式參數不一致,若要改寫成呼叫其他服務,記得把編碼對象改成正確的變數。
把 QR Code 直接產生在瀏覽器端,不必經過任何外部服務,自由度最高,也不受第三方服務存廢影響。原始 demo 可參考 https://hxend.com/jsqrcode/test/。
<script type="text/javascript" src="qrgen.min.js"></script>
<div id="qrcode"></div>
<script type="text/javascript">
qrcode(document.getElementById('qrcode'), {
data: 'https://example.com'
});
</script>
這種做法的優點是可控:輸出的是 canvas 或 DOM 節點,要調色、調尺寸、後製加工都在自己手上。
最偷工減料的一招,一行標籤搞定:
<img src="https://qrcoder.sinaapp.com/?t=hello world" />
缺點很明顯:能不能用取決於對方服務是否還活著,且參數可調度有限。適合臨時 demo,不適合正式專案。
下面這份取自 https://hxend.com/jsqrcode/test/ 的範例,把邊緣清理、格點大小、模塊造型(液體/方塊/圓形)與前景背景配色都開成了控制項,是四個方案裡最能玩的:
<!doctype html>
<html>
<head>
<title>QRCode</title>
<script type="text/javascript" src="qrcode-light.js"></script>
<script type="text/javascript" src="qrgen.js"></script>
</head>
<body>
<h1>二維碼生成</h1>
<div>
圖片: <img id="qrimg" src="sample.png" />
<label><input id="qrclearedges" type="checkbox" checked />清理邊緣</label>
</div>
<div><input id="fimg" type="file" /></div>
<div>文本: <textarea id="qrtext">https://www.example.com</textarea></div>
<div>大小: <input id="cellSize" type="range" min="2" max="10" value="6" /></div>
<table>
<tr>
<td rowspan="2">效果:</td>
<td colspan="3"><input id="cellEffect" type="range" min="-50" max="50" step="5" value="0" /></td>
</tr>
<tr id="cellEffectStops">
<td><a href="#" data-l>液體</a></td>
<td><a href="#" data-s>方塊</a></td>
<td><a href="#" data-r>圓</a></td>
</tr>
</table>
<div>
Foreground color: <input id="colorFore" type="color" value="#4169e1" />
Background color: <input id="colorBack" type="color" value="#ffffff" /><br />
Outside-border color: <input id="colorOut" type="color" value="#cd5c5c" />
Inside-border color: <input id="colorIn" type="color" value="#191970" />
</div>
<button id="qrgen">生成</button>
<div id="qrcode"></div>
<script src="take.js"></script>
</body>
</html>
方案三最省事,適合臨時驗證;方案一與方案三都依賴外部服務,正式專案不建議;方案二與方案四都在自己手上跑,可控性最好,其中方案四的可調參數最豐富。挑選時,先問自己兩件事:這個 QR Code 有沒有客製需求?能不能接受它依賴第三方?答案通常就浮現了。