js生成二维码——QRCode.js中文文档

QRCode v1.2.2
原文地址
API文档

一、安装

项目文件夹中执行

npm install --save qrcode

或者,全局安装

npm install -g qrcode

二、使用

在javascript中使用

Module bundlers

<!-- index.html -->
<html>
  <body>
    <canvas id="canvas"></canvas>
    <script src="bundle.js"></script> 
  </body>
</html>
// index.js -> bundle.js
var QRCode = require('qrcode')
var canvas = document.getElementById('canvas')
 
QRCode.toCanvas(canvas, 'sample text', function (error) {
  if (error) console.error(error)
  console.log('success!');
})

Precompiled bundle

<canvas id="canvas"></canvas>
 
<script src="/build/qrcode.min.js"></script>
<script>
  QRCode.toCanvas(document.getElementById('canvas'), 'sample text', function (error) {
    if (error) console.error(error)
    console.log('success!');
  })
</script> 

如果通过npm安装,文件存储在node_modules/qrcode/build/folder中。

在ES6/ES7中使用

import QRCode from 'qrcode' 
// import引入可能会导致报错,可以尝试require
// const QRCode = require('qrcode');
 
// With promises
QRCode.toDataURL('I am a pony!')
  .then(url => {
    console.log(url)
  })
  .catch(err => {
    console.error(err)
  })
 
// With async/await
const generateQR = async text => {
  try {
    console.log(await QRCode.toDataURL(text))
  } catch (err) {
    console.error(err)
  }
}

三、模糊识别(此处为意译,原文直译为:纠错级别)

在二维码部分模糊的情况下依然可以进行识别,分为四个识别等级。更高的级别可以识别更模糊的二维码,但会降低二维码的容量(见第四节)。
如果生成的二维码不会被破坏,建议使用低识别等级。

等级 最大模糊面积
L(低级) ≤7%
M(中级) ≤15%
Q(四分之一) ≤25%
H(高级) ≤30%

可以通过options.errorCorrectionLevel属性设置错误级别。
如果未指定,则默认值为M。

QRCode.toDataURL('some text', { errorCorrectionLevel: 'H' }, function (err, url) {
  console.log(url)
})

四、二维码容量

容量取决于二维码的版本和模糊识别等级,编码模式也会影响可存储数据的量。

二维码版本:即二维码的规格,二维码共有40种规格的矩阵,从21x21(版本1),到177x177(版本40),每一版本比前一版本的边增加4个模块。

下表显示了每种编码模式和每个模糊识别等级的最大可存储字符数。

编码模式 L(低级) M(中级) Q(四分之一) H(高级)
数字 7089 5596 3993 3057
数字+字母 4296 3391 2420 1852
字节 2953 2331 1663 1273
汉字 1817 1435 1024 784

注意:使用混合模式(见第五节)时,最大字符数可能不同。

可以通过options.version属性设置二维码版本。
如果未指定版本,则将使用更合适的值。除非需要特定版本,否则不需要此选项。

QRCode.toDataURL('some text', { version: 2 }, function (err, url) {
  console.log(url)
})

五、编码模式

编码模式可以更有效的方式编码字符串。编码模式取决于字符串内容。

编码模式 字符 压缩
数字 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 3个字符由10位表示
数字+字母 0–9, A–Z (大写), 空格, $, %, *, +, -, ., /, : 2个字符由11位表示
汉字 基于JIS X 0208的Shift JIS系统的特征 2个汉字由13位表示
字节 ISO / IEC 8859-1字符集中的字符 每个字符由8位表示

如果输入文本未知,选择正确的模式可能会很棘手。
在这些情况下,字节模式是最佳选择,因为所有字符都可以用它进行编码。
但是,如果QR码阅读器支持混合模式,则使用自动模式可能会产生更好的效果。

混合模式

混合模式也是可能的。可以从具有不同编码模式的一系列段生成二维码以优化数据压缩。
但是,从模式切换到另一种模式的成本可能会导致最坏的结果,如果不考虑它。有关如何指定具有不同编码模式的段的示例,请参见手动模式。

自动模式

默认使用自动模式。
输入字符串在各种段中自动分割,优化后使用混合模式产生最短的比特流。
这是生成二维码的首选方式。
例如,字符串ABCDE12345678?A1A将分为3个段,具有以下模式:

分割 编码模式
ABCDE 数字+字母
12345678 数字
?A1A 字节

段和模式的任何其他组合将导致更长的比特流。
如果您需要保持较小的QR码,此模式将产生最佳效果。

手动模式

如果自动模式不适合您或您有特定需求,也可以使用手动模式指定每个段。通过这种方式,不会应用任何段优化。
分段列表可以作为对象数组传递:

var QRCode = require('qrcode')
 
var segs = [
  { data: 'ABCDEFG', mode: 'alphanumeric' },
  { data: '0123456', mode: 'numeric' }
]
 
QRCode.toDataURL(segs, function (err, url) {
  console.log(url)
})

汉字模式

使用汉字模式可以以优化的方式对Shift JIS系统中的字符进行编码。
遗憾的是,没有办法从例如以UTF-8编码的字符计算Shifted JIS值,因此需要从输入字符到SJIS值的转换表。
默认情况下,此表不包含在包中,以使包尽可能小。

如果您的应用程序需要汉字支持,则需要传递一个函数,该函数负责将输入字符转换为适当的值。

lib通过可选文件提供辅助方法,您可以包含该文件,如下例所示。

注意:仅当您希望受益于数据压缩时才需要支持汉字模式,否则仍然可以使用字节模式对汉字进行编码。

var QRCode = require('qrcode')
var toSJIS = require('qrcode/helper/to-sjis')
 
QRCode.toDataURL(kanjiString, { toSJISFunc: toSJIS }, function (err, url) {
  console.log(url)
})

使用预编译包:

<canvas id="canvas"></canvas>
 
<script src="/build/qrcode.min.js"></script>
<script src="/build/qrcode.tosjis.min.js"></script>
<script>
  QRCode.toCanvas(document.getElementById('canvas'),
    'sample text', { toSJISFunc: QRCode.toSJIS }, function (error) {
    if (error) console.error(error)
    console.log('success!')
  })
</script> 

六、多字节字符

初始二维码标准中不存在对多字节字符的支持,但可以在字节模式下编码UTF-8字符。

二维码提供了一种通过ECI(扩展信道解释)指定不同类型字符集的方法,但它尚未在此lib中完全实现。

但是,大多数二维码阅读器即使没有ECI也能识别多字节字符。

请注意,单个汉字/假名或表情符号最多可占用4个字节。


七、API文档

点此跳转至https://www.npmjs.com/package/qrcode#api

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,311评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,339评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,671评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,252评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,253评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,031评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,340评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,973评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,466评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,937评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,039评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,701评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,254评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,259评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,485评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,497评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,786评论 2 345

推荐阅读更多精彩内容

  • 字符是用户可以读写的最小单位。计算机所能支持的字符组成的集合,就叫做字符集。字符集通常以二维表的形式存在。二维表的...
    刘惜有阅读 8,070评论 2 14
  • 在线视频演示 我与二维码的故事,是从一张扫不出来的二维码开始的。 如下图: 上面的这张二维码,我们的Android...
    三眼卡夫卡a阅读 2,744评论 26 33
  • 👏金星老师说:等我女儿长大了,我会告诉她,如果一个男人心疼你挤公交,埋怨你不按时吃饭,一直提醒你少喝酒伤身体,阴雨...
    谁道青春疯狂阅读 153评论 1 2
  • 还是个小姑娘的时候,我扎着高高的马尾,戴着鲜艳的发带,或红或绿或粉,每天象个花蝴蝶围着大人们飞来飞去。妈妈是个整洁...
    木兰禅舞阅读 360评论 0 2
  • 文/陈叶子 天色将暗,城市里各种标志性的建筑上都亮起了灯,让人不能不感受到整个城市的繁华。我与她并肩走进这家餐馆,...
    chenyezizjnu阅读 244评论 0 0