二維碼已成移動互聯連接物理與數字世界的標準入口。jquery-qrcode 是一款純前端、零依賴(除 jQuery)、體積極小(<4KB gz)的二維碼生成插件,支持 Canvas/Table 兩種渲染模式。本文詳細講解引入方式、核心參數、中文亂碼解決方案、進階定制,並提供開箱即用的完整示例。
https://cdn.jsdelivr.net/npm/jquery-qrcode@1.0.0/jquery.qrcode.min.js<script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/jquery-qrcode@1.0.0/jquery.qrcode.min.js"></script>
<!-- 中文支持需額外引入 utf16to8.js(見下文) -->
<div id="qrcode"></div>
<script>
$("#qrcode").qrcode("https://www.example.com"); // 默認 Canvas 256x256
</script>
$("#qrcode").qrcode({
text: "https://www.example.com", // 內容(必填)
render: "canvas", // "canvas" | "table" (IE8- 需用 table)
width: 256, // 寬度 px
height: 256, // 高度 px
typeNumber: -1, // 版本 1-40,-1 自動
correctLevel: QRErrorCorrectLevel.H, // 糾錯級別 L/M/Q/H
background: "#ffffff", // 背景色
foreground: "#000000" // 前景色
});
| 參數 | 說明 | 建議 |
|---|---|---|
render | Canvas 支持右鍵保存圖片;Table 用 <table><td> 模擬,兼容極舊瀏覽器 | 現代項目用 canvas |
correctLevel | L:7% M:15% Q:25% H:30% 容錯率。H 級適合帶 Logo/圖標覆蓋 | 帶 Logo 用 H,普通用 M |
typeNumber | 1-40 對應尺寸/容量,-1 自動計算最小版本 | 保持 -1 |
原因:庫內部用 charCodeAt() 獲取 Unicode 碼點(UTF-16),但 QR 碼標準編碼為 UTF-8。中文 UTF-16 2 字節,UTF-8 3 字節,導致編解碼不一致產生亂碼。
// utf16to8.js
function utf16to8(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); }
else if (c > 0x07FF) {
out += String.fromCharCode(0xE0 | ((c >> 12) & 0x0F));
out += String.fromCharCode(0x80 | ((c >> 6) & 0x3F));
out += String.fromCharCode(0x80 | (c & 0x3F));
} else {
out += String.fromCharCode(0xC0 | ((c >> 6) & 0x1F));
out += String.fromCharCode(0x80 | (c & 0x3F));
}
}
return out;
}
<script src="utf16to8.js"></script>
$("#qrcode").qrcode({
text: utf16to8("腳本之家:https://www.jb51.net/"), // 必須轉碼
render: "canvas",
width: 256, height: 256
});
現代替代**:ES6+ 環境直接用 unescape(encodeURIComponent(str)) 實現 UTF-8 編碼,無需額外文件:
function toUTF8(str) { return unescape(encodeURIComponent(str)); }
$("#qrcode").qrcode({ text: toUTF8("中文內容") });
// Canvas 模式
var canvas = $("#qrcode canvas")[0];
var dataURL = canvas.toDataURL("image/png"); // Base64 PNG
// 可直接
或上傳服務器 / 用戶下載
// Table 模式無法直接導出圖片,需 html2canvas 截圖
$("#qrcode").qrcode({
text: utf16to8("https://www.example.com"),
correctLevel: QRErrorCorrectLevel.H, // 關鍵:30% 容錯
render: "canvas",
width: 300, height: 300
});
// 生成後疊加 Logo
setTimeout(function() {
var $canvas = $("#qrcode canvas");
var ctx = $canvas[0].getContext("2d");
var logo = new Image();
logo.src = "logo.png";
logo.onload = function() {
var w = $canvas.width(), h = $canvas.height();
var lw = w * 0.2, lh = h * 0.2; // Logo 佔 20%
ctx.drawImage(logo, (w-lw)/2, (h-lh)/2, lw, lh);
// 可選:Logo 後方加白底圓角矩形增強識別
};
}, 100);
setTimeout。qrcode、Python qrcode、Java zxing、Go go-qrcode)。<img>。display:none 時初始化 → Canvas 尺寸為 0 → 顯示時空白 → **初始化前確保容器可見**或指定 width/height。.qrcode() → 疊加多個 Canvas/Table → **調用前 $el.empty()**。jquery-qrcode 以「輕量、零依賴、API 簡單」成為前端生成二維碼的經典選擇。理解其 UTF-8 編碼機制、渲染模式差異、容錯級別應用,能讓你在營銷活動頁、設備綁定、名片分享等場景快速交付高質量二維碼功能。