概述
本 Demo 展示了如何使用 BC_QRCODE 公式在单元格中生成 QR 二维码。通过设置不同的参数,演示了纠错级别、编码模式、版本号、掩码、连接编码等配置对二维码生成的影响。
实现思路
创建表格并设置基础数据(服务名称和号码)
在不同列使用 BC_QRCODE 公式,传入不同的参数组合
每一列展示一种参数变化的效果,方便对比观察
设置单元格样式和错误提示信息
代码解析
设置表头和数据
创建了一个服务名称和号码的表格,第三行数据较长用于测试连接模式。表头说明了每一列二维码的参数配置。
批量设置二维码公式
通过循环为每行设置多个二维码公式,每个公式对应不同的参数配置:
第 3 列:默认参数
第 4 列:纠错级别设为 "H"(最高,约 30% 纠错能力)
第 5 列:使用模型 1(compact 模式)
第 6 列:指定版本号为 8
第 7 列:指定掩码为 3
第 8-9 列:启用连接编码,分别设置编号为 0 和 1
设置表格样式和提示信息
二维码需要足够的显示空间,因此设置了较大的行高和列宽。对于连接模式,当数据太短时会显示错误提示。
运行效果
第一列显示默认参数生成的二维码
第二列显示高纠错级别的二维码(更密集但容错能力更强)
第三至五列展示不同模型、版本、掩码参数下的二维码变化
最后两列展示连接编码模式,用于将长数据分割成多个二维码
对于较短的测试数据(如 110、119),连接模式无法创建,会显示红色错误提示
第三行较长的测试数据可以正常生成连接模式的二维码
API 参考
BC_QRCODE 公式
常用参数说明:
value:要编码的内容(必填)
color:二维码颜色,默认 'rgb(0,0,0)'
backgroundColor:背景颜色,默认 'rgb(255,255,255)'
errorCorrectionLevel:纠错级别,可选 'L'(低)、'M'(中)、'Q'(较高)、'H'(高),默认 'L'
model:编码模式,可选 1 或 2,默认 2
version:版本号,可选 'auto' 或 1-40,默认 'auto'
mask:掩码图案,可选 'auto' 或 0-7,默认 'auto'
connection:是否使用连接编码,可选 true 或 false,默认 false
connectionNo:连接编码中的符号编号,范围 0-15,默认 0
注意:使用条码功能需要引用 gc.spread.sheets.barcode.*.*.*.js 文件。
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
initSpread(spread);
};
var FORMULA = 'BC_QRCODE';
function initSpread(spread) {
var sheet = spread.getSheet(0);
spread.suspendPaint();
_initBasicSheet(sheet);
spread.resumePaint();
}
function _initBasicSheet(sheet) {
sheet.name('customSheet');
_setData(sheet);
_setStyle(sheet);
for (var row = 3; row < 6; row++) {
sheet.setFormula(row, 3, '=' + FORMULA + '(C' + (row + 1) + ')');
sheet.setFormula(row, 4, '=' + FORMULA + '(C' + (row + 1) + ',,,"H")');
sheet.setFormula(row, 5, '=' + FORMULA + '(C' + (row + 1) + ',,,,1)');
sheet.setFormula(row, 6, '=' + FORMULA + '(C' + (row + 1) + ',,,,,8)');
sheet.setFormula(row, 7, '=' + FORMULA + '(C' + (row + 1) + ',,,,,,3)');
sheet.setFormula(row, 8, '=' + FORMULA + '(C' + (row + 1) + ',,,,,,,"true",0)');
sheet.setFormula(row, 9, '=' + FORMULA + '(C' + (row + 1) + ',,,,,,,"true",1)');
}
}
function _setStyle(sheet) {
for (var row = 3; row < 6; row++) {
sheet.setRowHeight(row, 80);
}
sheet.setColumnWidth(0, 20);
for (var col = 1; col < 3; col++) {
sheet.setColumnWidth(col, 160);
}
for (var col = 3; col < 10; col++) {
sheet.setColumnWidth(col, 120);
}
sheet.setColumnWidth(10, 200);
sheet.setColumnWidth(4, 200);
sheet
.getRange(1, 1, 2, 10)
.foreColor('#000')
.backColor('#FFF3CE')
.setBorder(new GC.Spread.Sheets.LineBorder('orange', GC.Spread.Sheets.LineStyle.thin), { all: true });
sheet
.getRange(1, 1, 5, 10)
.vAlign(GC.Spread.Sheets.VerticalAlign.center)
.hAlign(GC.Spread.Sheets.HorizontalAlign.center)
.setBorder(new GC.Spread.Sheets.LineBorder('orange', GC.Spread.Sheets.LineStyle.medium), { outline: true });
sheet.getRange(1, 1, 1, 9).foreColor('#000').backColor('#FFF3CE').wordWrap(true);
sheet.getRange(1, 2, 5, 1).wordWrap(true);
sheet.getCell(3, 10).value('未生成二维码,条形码数据太短,无法创建连接符号。').wordWrap(true).foreColor("red");
sheet.getCell(4, 10).value('未生成二维码,条形码数据太短,无法创建连接符号。').wordWrap(true).foreColor("red");
sheet.addSpan(2, 8, 1, 2);
}
function _setData(sheet) {
var headers = [[
'默认',
'更改纠错级别',
'更改模型',
'更改版本',
'更改掩码',
'更改连接和连接编号',
'',
'说明'
]];
sheet.setArray(2, 3, headers)
var dataArray = [
['警察', 110],
['火警', 119],
['', 'abcdefghijklmnopqrstuvwxyz1234567890']
];
sheet.setArray(3, 1, dataArray);
sheet.addSpan(1, 1, 2, 1);
sheet.addSpan(1, 2, 2, 1);
sheet.addSpan(1, 3, 1, 7);
sheet.setValue(1, 1, '服务');
sheet.setValue(1, 2, '号码');
sheet.setValue(1, 3, '二维码');
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="zh-cn" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-barcode/dist/gc.spread.sheets.barcode.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" class="sample-tutorial"></div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}