概述
本 Demo 展示了如何使用 BC_DataMatrix 公式在单元格中生成 Data Matrix 二维码。Demo 演示了三种不同的 ECC(纠错码)模式:默认模式、ECC000 模式和 ECC200 模式,通过实际对比展示了不同编码模式的效果。
实现思路
创建工作表并设置基础数据(紧急服务名称和号码)
使用 CONCAT 公式将服务名称和号码连接成完整的编码内容
使用 BC_DataMatrix 公式为每行数据生成三种不同 ECC 模式的二维码
设置单元格样式和布局,包括合并单元格、边框、对齐方式等
代码解析
数据准备
这段代码创建了一个包含紧急服务名称和号码的数组,并写入工作表。
生成二维码公式
这段代码为每一行数据生成三种二维码:
第 3 列:使用默认参数生成二维码
第 4 列:使用 ECC000 模式(第 4 个参数指定 eccMode)
第 5 列:使用 ECC200 模式
value 通过 CONCAT 公式将服务名称和号码连接,例如:"Police: 110"。
样式设置
设置二维码显示区域的行高为 80,确保二维码清晰可见。合并表头单元格,使表格布局更加美观。
运行效果
表格显示四种紧急服务信息(警察、消防、救护车、交通事故)
每行数据对应三列二维码,分别使用默认、ECC000 和 ECC200 三种编码模式
二维码自动适应单元格大小,用户可以直观比较不同 ECC 模式的效果
API 参考
BC_DataMatrix 公式
主要参数说明:
value:要编码的内容,字符串类型(必填)
color:二维码颜色,默认值为 'rgb(0,0,0)'
backgroundColor:背景颜色,默认值为 'rgb(255,255,255)'
eccMode:纠错码模式,可选值:'ECC000'、'ECC050'、'ECC080'、'ECC100'、'ECC140'、'ECC200'
ecc200SymbolSize:ECC200 符号大小,默认值为 'auto'
ecc200EncodingMode:ECC200 编码模式,默认值为 'auto'
structureAppend:是否为结构化追加消息的一部分(仅适用于 ECC200),默认值为 false
注意:参数名中的拼写错误(如 backgroudColor、ecc200EndcodingMode)在官方 API 中确实存在,使用时请按照实际 API 定义传参。
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
initSpread(spread);
};
var FORMULA = 'BC_DataMatrix';
function initSpread(spread) {
var sheet = spread.getSheet(0);
spread.suspendPaint();
_initCustomSheet(sheet);
spread.resumePaint();
}
function _initCustomSheet(sheet) {
sheet.name('customSheet');
_setData(sheet);
_setStyle(sheet);
for (var row = 3; row < 7; row++) {
var value = 'CONCAT(B' + (row + 1) + ', ": ",C' + (row + 1) + ')';
sheet.setFormula(row, 3, '=' + FORMULA + '(' + value + ')');
sheet.setFormula(row, 4, '=' + FORMULA + '(' + value + ', , ,"ECC000")');
sheet.setFormula(row, 5, '=' + FORMULA + '(' + value + ', , ,"ECC200")');
}
}
function _setData(sheet) {
sheet.getCell(1, 1).value('服务');
sheet.getCell(1, 2).value('号码');
sheet.getCell(1, 3).value('Data Matrix 码');
sheet.getCell(2, 3).value('默认');
sheet.getCell(2, 4).value('ECC100');
sheet.getCell(2, 5).value('ECC200');
var dataArray = [
['Police', 110],
['Fire Department', 119],
['Ambulance Service', 120],
['Traffic Accidents', 122],
];
sheet.setArray(3, 1, dataArray);
}
function _setStyle(sheet) {
for (var row = 3; row < 7; row++) {
sheet.setRowHeight(row, 80);
}
sheet.addSpan(1, 1, 2, 1)
sheet.addSpan(1, 2, 2, 1)
sheet.addSpan(1, 3, 1, 3)
sheet.setColumnWidth(0, 20);
sheet.setColumnWidth(1, 200);
sheet.setColumnWidth(2, 80);
sheet.setColumnWidth(3, 80);
sheet.setColumnWidth(4, 80);
sheet.setColumnWidth(5, 80);
sheet.getRange(1, 1, 2, 5)
.foreColor('#000')
.backColor('#FFF3CE')
.borderLeft(new GC.Spread.Sheets.LineBorder('orange', GC.Spread.Sheets.LineStyle.thin), { outline: true })
.borderBottom(new GC.Spread.Sheets.LineBorder('orange', GC.Spread.Sheets.LineStyle.thin), { outline: true });
sheet
.getRange(1, 1, 6, 5)
.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, 5, 1).wordWrap(true);
}
<!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;
}