HTML本身不支持直接生成DataMatrix码,因其无原生标签或API;所有实现均依赖JS库(如datamatrix-js、datamatrix-svg)或服务端渲染,且qrcode.js等QR专用库不支持DataMatrix。
HTML 本身不支持直接生成 DataMatrix 码——它没有原生的
标签,也不在 Canvas 2D API 或 CSS 规范中定义该码制。所有“HTML 生成 DataMatrix”的实际方案,都依赖外部 JavaScript 库或服务端渲染。
为什么不能用 qrcode.js 生成 DataMatrix
(包括其常见变体如
、
)只支持 QR Code,**不支持 DataMatrix**。它的核心算法、编码表、纠错逻辑、符号尺寸规则全部针对 QR 标准设计。尝试传入
会静默失败或抛出
错误。
常见错误现象:
控制台报错
页面空白,
无内容,但无任何提示
生成了看似二维码的图案,但扫描器识别为“无效格式”或直接拒识
原因很简单:DataMatrix 和 QR 是两种完全独立的 ISO/IEC 标准(分别是 ISO/IEC 16022 和 ISO/IEC 18004),编码结构、模块排布、纠错机制互不兼容。
立即学习
“
前端免费学习笔记(深入)
”;
前端可用的 DataMatrix JS 库只有这几个
目前稳定、轻量、可直接在浏览器运行的开源 DataMatrix 库极少,真正可用的只有:
:基于 TypeScript 编写,支持 UCC/EAN.GS1 模式,输出
或
;需注意它默认不处理
(ASCII 29)字符,GS1 场景必须手动替换为
:较老,仅支持 ASCII 子集,不支持长方形尺寸或 GS1 结构化数据,已停止维护
:纯 SVG 输出,适合打印,但不支持纠错级别调节,对中文等多字节字符支持弱
示例(使用
):
⚠️ 注意:
并非固定值,它会根据输入长度自动选择最小可行版本(如
、
…
),无法强制指定;若内容超限,
会抛出
。
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
下载
GS1 DataMatrix 必须手动注入 GS 字符
GS1 标准要求字段分隔符使用 ASCII 29(Group Separator,
),不是换行符
,也不是反斜杠加字母
。很多用户在前端拼接字符串时直接写
,结果扫码器读出的是乱码或截断数据。
正确做法:
用
或
表示 GS
确保整个字符串 UTF-8 编码后仍符合 DataMatrix 的字符集限制(推荐先转为 ASCII 兼容模式,如 C40 或 Text 编码)
若使用
,它默认启用 Auto 模式选编码,但遇到混合大小写+数字时可能选错——建议显式指定
或
错误示例:
(无 GS)→ 扫码器无法解析应用标识符;
(用 \n 代替 GS)→ 多数工业扫描器直接忽略该字段。
长方形 DataMatrix 在前端渲染容易变形
DataMatrix 支持矩形尺寸(如
、
),但前端 Canvas 渲染时,若未严格按模块比例缩放,会导致黑白模块被拉伸,降低扫码成功率。
关键点:
Canvas 的
/
必须是模块数的整数倍(例如 12×30 模块,canvas 尺寸应设为
,每模块 10px)
禁用 CSS 缩放:
会破坏模块等比性,必须用内联
/
属性
的
方法不自动适配矩形——需手动计算目标宽高比,否则默认按正方形填充
最稳妥的方式:生成 SVG(矢量),而非 Canvas 或 PNG。SVG 能无损缩放,且可直接嵌入 HTML:
。但要注意部分老旧扫码枪对 SVG 渲染的灰度反差敏感,需确保 black 模块用
,white 背景用
,避免透明背景。
真正难的不是“怎么画出来”,而是让产线扫码器在油污、反光、小尺寸金属件上稳定识别——这取决于字符编码是否合规、GS 是否到位、模块尺寸是否匹配硬件最小分辨率,以及纠错等级是否覆盖实际工况。前端能做的有限,关键决策点往往在数据构造阶段就已锁定。
qrcode.jsqrcode-generatorqrcode.reacttype: 'datamatrix'Unknown typeUncaught Error: Invalid type: datamatrixdatamatrix-jsUint8ArrayGS\u001Djs-datamatrixdatamatrix-svgdatamatrix-jsimport { encode } from 'datamatrix-js';
const data = '\u001D0101234567890128\u001D10ABCD'; // GS1 示例,\u001D = GS
const matrix = encode(data, { size: 'default', shape: 'square' });
const canvas = document.getElementById('dm-canvas');
const ctx = canvas.getContext('2d');
ctx.clearRect(0, 0, canvas.width, canvas.height);
matrix.draw(ctx, 0, 0, canvas.width, canvas.height);size: 'default'10x1012x12144x144encode()Error: Data too long for symbol sizeGS\n\GS'01' + ai + '\n10' + lot\u001DString.fromCodePoint(0x1D)datamatrix-jsencoding: 'text''c40''01123456789012810ABCD''011234567890128\n10ABCD'8x1812x30widthheight120×300canvas { width: 100%; height: auto; }widthheightdatamatrix-jsdraw()#000#fff