二维码生成使用了一款基于Javascript环境开发的插件 uQRCode ,它不仅适用于uniapp,也适用于所有Javascript运行环境的前端应用和Node.js。
uQRCode 插件地址:https://ext.dcloud.net.cn/plugin?id=1287
目录
1、npm安装
2、通过import引入
3、生成二维码
4、自定义绘制样式与内容
1、npm安装
npm install uqrcodejs
# 或者
npm install @uqrcode/js
2、通过import引入
import UQRCode from 'uqrcodejs'; // npm install uqrcodejs
// 或者
import UQRCode from '@uqrcode/js'; // npm install @uqrcode/js
3、生成二维码
如果只是生成二维码的话实现也特别简单,在template中加入canvas组件,并在script中创建UQRCode对象配置参数调用绘制方法即可。
<canvas id="qrcode" canvas-id="qrcode" style="width: 300px;height:300px;" />
const qr = new UQRCode();
qr.data = '二维码内容';
qr.size = 300;
qr.make();
const ctx = uni.createCanvasContext('qrcode', this); // 组件内调用需传this,vue3 中 this 为 getCurrentInstance()?.proxy
qr.canvasContext = ctx;
qr.drawCanvas();
当然,除绘制简单的黑白块二维码外,UQRCode还支持定制块颜色、背景颜色、块形状、块之间的间距等,可绘制出各种花里胡哨的二维码,具体用法可查阅官方文档,本文不做阐述,
4、自定义绘制样式与内容
原本是可以先通过UQRCode插件把二维码生成并保存为图片,再绘制到新的画布上,但考虑到绘制时长和性能问题,我还是更想直接在二维码的画布上进行绘制。
4.1 定义配置信息
const config = {qrcodeTitle: '二维码标题',logo: '二维码中间logo链接',qrcodeTitlePosition: 'center',borderWidth: 10,
};/** 是否为标题logo */const isTitleLogo = config.qrcodeTitle && config.logo && config.qrcodeTitlePosition === 'center';/** 是否有标题 */const hasTitle = config.qrcodeTitle && ['top', 'bottom'].includes(config.qrcodeTitlePosition);
其中borderWidth为边框宽度,qrcodeTitlePosition为二维码标题位置
qrcodeTitlePosition 枚举值 | 效果 | 条件 |
center | 标题在二维码中间 | 当logo为空且qrcodeTitle有值时,会将qrcodeTitle的内容生成为白底黑字的图片绘制在二维码中间。 |
top | 标题在二维码上方 | 当qrcodeTitle有值时,会将qrcodeTitle的内容绘制在二维码上方。 |
bottom | 标题在二维码上方 | 当qrcodeTitle有值时,会将qrcodeTitle的内容绘制在二维码下方。 |
4.2 初始配置:指定二维码内容和大小,将areaColor=''由自己绘制二维码背景,且在qr.make()之前设置margin留出绘制边框的空间,预留空间包含边框宽度(borderWidth)和边框与二维码的间距(示例为10)
const qr = new UQRCode();
qr.data = '二维码内容';
qr.size = 300;
qr.areaColor = ''; // 不绘制背景,否则会覆盖边框或文本
qr.drawReserve = true; // 保留绘制,本次绘制是否接着上一次绘制。是二维码绘制完是否还能上此基础上绘制的关键
if (config.borderWidth > 0)qr.margin = config.borderWidth + 10;
qr.make();
4.3 绘制logo:如果二维码中间需要绘制logo,UQRCode是支持设置logo的,无需自己绘制。
if (config.logo)qr.foregroundImageSrc = config.logo; // 网络图片需先下载下来
4.4 绘制二维码背景:如果二维码上下方有标题则需要高度需要留出空间来绘制(示例用 hasTitleDraw 来判断上下方是否有标题需绘制)
const ctx = uni.createCanvasContext('qrcode', this); // 组件内调用需传this,vue3 中 this 为 getCurrentInstance()?.proxy
const hasTitleDraw = !isTitleLogo && hasTitle;
ctx.setFillStyle('#fff');
ctx.rect(0, 0, 300, hasTitleDraw ? 356 : 300);
ctx.fill();
4.5 计算字符占用长度:用来计算每行绘制的文字个数
function textLength(str: string, index?: number) {let m = 0;const a = str.split('');for (let i = 0; i < a.length; i++) {if (a[i].charCodeAt(0) < 299)m++;elsem += 2;if (index) {if (m == index)return i;else if (m > index)return i - 1;else if (i == a.length - 1)return a.length;}}return m;
}
4.6 绘制标题
const isTop = config.qrcodeTitlePosition === 'top';
const title = config.qrcodeTitle;
if (hasTitleDraw) {ctx.setFontSize(30);ctx.setFillStyle('#000');ctx.setTextBaseline('top');ctx.fillText(title,Math.max(300 - textLength(title) * 16) / 2, 0),isTop ? 16 : 316,);if (isTop) { // 标题在二维码上方,整个二维码向下偏移qr.getDrawModules().forEach((item) => {item.y += 56;});}
}
4.7 绘制边框
const hasTopTitle = hasTitle && isTop;
if (qr.margin > 0) {ctx.beginPath();ctx.setFillStyle('#000');// 左侧borderctx.rect(0, hasTopTitle ? 58 : 0, config.borderWidth, 300);// 右侧borderctx.rect(300 - config.borderWidth, hasTopTitle ? 58 : 0, config.borderWidth, 300);// 上方borderctx.rect(0, hasTopTitle ? 58 : 0, 300, config.borderWidth);// 下方borderctx.rect(0, 300 - config.borderWidth + (hasTopTitle ? 58 : 0), 300, config.borderWidth);ctx.fill();
}
4.8 绘制二维码中间的标题logo
qr.canvasContext = ctx;
qr.drawCanvas(false).then(async () => {// 绘制标题图片logoif (isTitleLogo) {// 绘制logo背景ctx.beginPath();ctx.setFillStyle('#fff');const x = 300 * 3 / 4 / 2;const y = x + (hasTopTitle ? 56 : 0);ctx.rect(x, y, 76, 76);ctx.fill();// 绘制logo文字ctx.setFontSize(30);ctx.setFillStyle('#000');ctx.setTextBaseline('top');// 绘制第1行文字let s = textLength(title) > 4 ? y + 14 : y + 28;let i = textLength(title, 4);const t1 = title.slice(0, i + 1);ctx.fillText(t1, x + (76 - textLength(t1) * 16) / 2, s);let t2 = title.slice(i + 1);// 绘制第2行文字if (t2.length > 0) {s += 68;i = textLength(t2, 4);t2 = t2.slice(0, i + 1);ctx.fillText(t2, x + (76 - textLength(t2) * 16) / 2, s);}ctx.draw(true, async () => {// 绘制完成,这里可以进行保存图片操作,如果还是太快可以setTimeout});}else {// 绘制完成,这里可以进行保存图片操作,如果还是太快可以setTimeout}});