DIV CSS 佈局教程網

用 JavaScript 在前端產生名片與網址 QR Code
編輯:關於JavaScript     

直接上程式碼。以下示範如何用 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,但理解這段有助於看懂編碼的實際運作。

產生名片 QR Code

名片用的是 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 結構被注入額外欄位。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved