背景

之前浏览过草料二维码的网站，他的二维码美化功能很强大，可以分别自定义码眼和码点的形状和颜色，功能十分强大 💪！

碰巧之前写过一个 npm 插件 qrcode-with-logos (opens new window), 用于前端生成带 logo 的二维码。

而且在 github 的 issues 里有外国友人 👨‍🦱 问我能否实现不同样式的二维码，刚好以此作为新需求，模仿草料二维码的样式和功能，开发了 qrcode-with-logos 的 v1.1.0 版本。

有了 qrcode-with-logos 这款 npm 插件，你也可以在你的网站实现不同风格组合的 qrcode 了！

实现功能

• 自定义码眼码点颜色！
• 自定义码眼码点形状！
• 自动计算合适的 logo 大小！
• 自由选择不同宽高比的 logo, 不再是之前限定的 1:1
• 自动选择合适的容错率版本！
• 相比之前版本更快的绘制速度！

demo 及文档点击 👉这里 (opens new window),实现的效果如下：

实现原理

qrcode 的原理在这里就不过多介绍了，有兴趣的小伙伴可以网上搜索一下。

本插件是基于 qrcode 插件生成的记录二维码点阵的一维数组，从而得知每个点的黑白情况。

import QRCode from "qrcode";
const QRDATA = QRCode.create(content, nodeQrCodeOptions);

const size = QRDATA.modules.size;
const version = QRDATA.version;
const qrcodeArray = QRDATA.modules.data;

如：9*9 的点阵二维码，其数组长度 81,内容大致为：[1,1,1,1,1,1,1,0,0,0,0,0,....]，其中 1 代表黑点，0 代表白点。

/**判断当前坐标是否为黑点 */
function isDark(x: number, y: number) {
  return qrcodeArray[x + y * size] === 1;
}

根据此数据我们可以分别绘制码眼码点及 logo。

• 首先绘制码点，在绘制码点之前，我们需要计算 logo 所占位置的区域，此区域内不绘制码点，(之前是 logo 直接覆盖码点，效果不好)，提高绘制速度。

• 其次绘制码眼，码眼长度固定为 7 * 7， 码眼内部固定为 3*3 的实心矩形，当然也可以自由绘制其他形状。

• 最后在 logo 区域绘制 logo 及 logo 背景色。

逻辑比较简单，具体代码实现有兴趣的小伙伴请移步 Github (opens new window)!

踩坑过程

1. 之前版本是支持自定义 logo 的大小的，但是这种过于自由导致二维码的识别效率不高，容易出现识别不出的情况，因此这次版本去掉了自定义 logo 大小的功能，根据 qrcode 的容错率计算 logo 最大能占用的面积大小，用于计算 logo 的最大大小。

2. 在实现液化码点的时候，圆液化实现效果比较好，但是 fluid-line 实现的效果远不及原版的液化效果，有没有小伙伴有更好的思路可以在评论区或者 Github 讨论一下。