萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery.qrcode 插件生成二維碼完整指南:Canvas/Table 渲染、中文支持、參數詳解

二維碼已成移動互聯連接物理與數字世界的標準入口。jquery-qrcode 是一款純前端、零依賴(除 jQuery)、體積極小(<4KB gz)的二維碼生成插件,支持 Canvas/Table 兩種渲染模式。本文詳細講解引入方式、核心參數、中文亂碼解決方案、進階定制,並提供開箱即用的完整示例。

項目地址與引入

<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"                // 前景色
});
參數說明建議
renderCanvas 支持右鍵保存圖片;Table 用 <table><td> 模擬,兼容極舊瀏覽器現代項目用 canvas
correctLevelL:7% M:15% Q:25% H:30% 容錯率。H 級適合帶 Logo/圖標覆蓋帶 Logo 用 H,普通用 M
typeNumber1-40 對應尺寸/容量,-1 自動計算最小版本保持 -1

中文亂碼問題與解決方案

原因:庫內部用 charCodeAt() 獲取 Unicode 碼點(UTF-16),但 QR 碼標準編碼為 UTF-8。中文 UTF-16 2 字節,UTF-8 3 字節,導致編解碼不一致產生亂碼。

方案:utf16to8 轉碼函數

// 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 截圖

帶 Logo 二維碼(利用 H 級容錯)

$("#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);

批量生成 / 服務端渲染建議

  • 前端批量生成會阻塞主線程,大量(>50)時建議 Web Worker 或分批 setTimeout。
  • 高併發/SEO 需求場景,**後端生成圖片 URL** 更優(Node qrcode、Python qrcode、Java zxing、Go go-qrcode)。
  • 靜態站點可構建時預生成二維碼圖片,運行時直出 <img>。

避坑清單

  • ❌ 直接傳中文不轉碼 → 掃碼亂碼
  • ❌ 容器 display:none 時初始化 → Canvas 尺寸為 0 → 顯示時空白 → **初始化前確保容器可見**或指定 width/height。
  • ❌ 同一容器重複調用 .qrcode() → 疊加多個 Canvas/Table → **調用前 $el.empty()**。
  • ❌ Table 模式大尺寸(>300px)生成超大 DOM 樹 → 頁面卡頓 → **大尺寸必用 Canvas**。

jquery-qrcode 以「輕量、零依賴、API 簡單」成為前端生成二維碼的經典選擇。理解其 UTF-8 編碼機制、渲染模式差異、容錯級別應用,能讓你在營銷活動頁、設備綁定、名片分享等場景快速交付高質量二維碼功能。

copyright © 萬盛學電腦網 all rights reserved