- A+
所属分类:Web前端
现如今围绕微信生态相关开发已经非常常见,本期带来如何通过
qrcode.js
实现微信内置浏览器动态生成二维码并能够长按识别 以及 通过html2canvas
生成图片并长按保存
说几个知识点
- 微信长按弹出识别选项的原理
- 微信客户端检测到用户长按
img
标签 - 微信主动进行截屏并识别图片,二维码识别采用的是截屏而不是通过
img
标签 - 微信识别成功后执行相关操作
- 微信客户端检测到用户长按
- Base64
- Base64是网络上最常见的用于传输8Bit字节码的编码方式之一,Base64就是一种基于64个可打印字符来表示二进制数据的方法
- Blob
- HTML5中的Blob对象与MySQL中的BLOB对象有区别,HTML5中的Blob对象除了存放二进制数据外还可以设置这个数据的MINE类型,这相当于对文件的存储,其它很多二进制对象也是从这个对象继承的
canvas.toDataURL([type, encoderOptions])
type
: 指定图片类型,默认值image/png
encoderOptions
: 为image/jpeg
或image/webp
类型的图片设置图片质量,取值0-1,超出则以默认值0.92替代- 作用: 通过canvas进行转化图片
准备工作
- 结合微信规范明确需求
- 微信img标签通过src属性可实现长按弹出选项(保存至手机,图片为二维码的情况下会出现识别二维码)
- 二维码图片若为本地图片或服务器图片(即不需要进行动态生成)只需要正常编写代码即可实现
- 微信针对内置浏览器内的页面图片有着自己的一套适应逻辑与规范,canvas的图片和base64编码格式的图片在安卓与ios手机上会出现不同的问题
- 确定实现方案
- 本例采用第三方js库实现生成二维码
- 针对生成的base64编码的图片微信无法长按识别需要在前端进行格式和image对象重新转换
- 生成的图片弹窗展示,避免出现其他元素影响微信识别率
开发环境
- 开发平台
- MacOS
- 开发环境
- Vue + node
- 客户端环境
- Google Chrome
- Wechat Webview
技术实现
本例的技术实现方案均在Vue项目环境下实现的
引入第三方js库
-
提供两种引入方式,两种方式是不同的js库,方便大家选择和使用
- 本地引入
qrcode.js
// qrcode.js官方GitHub文档: https://github.com/davidshimjs/qrcodejs <script src="static/js/qrcode.js"></script>
- npm 引入
qrcodejs2
npm install qrcodejs2 import qrCode from 'qrcodejs2'
- 本地引入
组件中调用
-
HTML
<div class="qrcode-panel" id="qrcode"></div>
-
JS
- 简单调用
new QRCode(document.getElementById('qrcode'), 'your content'); // new QRCode(element, option) // element 显示二维码的元素或该元素的 ID // option 参数配置
- 标准调用
var qrcode = new QRCode(document.getElementById("qrcode"), { text: "https://www.xxx.com?did=123456&id=123&userid=456", width: 160, //图像宽度 height: 160, // 图像高度 render: 'canvas', // 生成格式(table 和 canvas) colorDark : "#000000", //前景色 colorLight : "#ffffff", //背景色 correctLevel : QRCode.CorrectLevel.H // 容错级别 }); // 容错级别,可设置为: QRCode.CorrectLevel.L(最大 7% 的错误能够被纠正) QRCode.CorrectLevel.M(最大 15% 的错误能够被纠正) QRCode.CorrectLevel.Q(最大 25% 的错误能够被纠正) QRCode.CorrectLevel.H(最大 30% 的错误能够被纠正)
- 其他公共方法
QRCode.makeCode(text) // 设置二维码内容 QRCode.clear() // 清除二维码
重置 Image 对象
-
重置的原因是原JS生成的 image 和 canvas 对象无法在微信端长按识别
var canvas = document.getElementsByTagName('canvas')[0]; var img = this.convertCanvasToImage(canvas); document.getElementById("qrcode").append(img); convertCanvasToImage(canvas) { //新建Image对象 var image = new Image(); // canvas.toDataURL 返回的是一串Base64编码的URL image.src = canvas.toDataURL("image/png"); image.id = 'qrcodeImg'; return image; }
后续细节处理
- 至此,一个能够满足长按识别的动态二维码已经生成,不继续处理的话会有两张二维码,长按对比就能看出,
qrcode.js
生成的二维码长按无法识别,而经过重置之后的对象是可以实现此功能的。 - 我的处理方式是两个二维码都保留,将二维码图片进行重新定位,将重置的二维码图片置于不能识别二维码上层,不去频繁操作DOM节点的显示隐藏。
- 生成的二维码通过
append
的方式插入到dom节点中,在关闭操作时需要将之前生成的canvas
和image
去除
微信内置浏览器生成canvas图片保存
- 上述教程可以实现动态生成二维码进行保存和长按识别,但是如果需要将HTML内容生成canvas保存就存在问题了。
- 针对保存需要注意的几个问题:
- canvas禁止跨域
- 安卓微信长按不能保存base64图片
- 微信限制Blob类型图片的保存
- 使用
canvas.toDataURL
绘制时的类型使用image/jpeg
进行保存
技术选型
- 使用第三方JS库
html2canvas
进行处理 - 识别和生成原理:
- 脚本直接在用户浏览器上截取网页或部分网页的"屏幕截图"
- "屏幕截图"基于DOM,因此它可能不是真实表示的100%准确,因为它没有制作实际的屏幕截图,而是根据页面上可用的信息构建屏幕截图
- 存在的问题:
- 正是因为
html2canvas
不是基于真正的屏幕截图去识别处理,所以脱离了文档流,或者文档流异常的元素会无法被截取下来 html2canvas
只会截取到目标元素宽高范围内的内容- 对部分css样式支持不好,兼容性差的属性列表
- 正是因为
- 一些可能需要的参数
useCORS
: 是否尝试使用CORS从服务器加载图像async
: 是否异步解析和呈现元素scale
: 用于渲染的比例。默认为浏览器设备像素比率window.devicePixelRatio
allowTaint
: 是否允许画布被污染,被污染的canvas是没法使用toDataURL()转base64流的,部分细节请 参考这里- 更多
html2canvas
参数请点击这里
引入第三方JS库
- 使用
html2canvas
import html2canvas from 'html2canvas'
组件中调用
- HTML
<div class="html2canvas-conetent" ref="canvasContent"> <img src="/static/images/canvas.jpg" alt="几行代码教你解决微信生成海报及二维码"> <span>测试Title</span> </div> <button @click="showCanvas()">生成canvas图片</button>
- JS
- 使用
html2canvas
推荐的promise方法
- 使用
showCanvas() { let self = this; html2canvas(self.$refs.canvasContent).then(function(canvas) { self.imgUrl = canvas.toDataURL(); self.showCanvasImg = true; }); } // 异步解析调用和呈现元素 showCanvas() { let self = this; html2canvas(self.$refs.canvasContent { async: true }).then(canvas => { self.imgUrl = canvas.toDataURL(); self.showCanvasImg = true; }); }
实现效果
源码地址
写在最后
- 如果你觉得这篇文章对你有益,烦请点赞以及分享给更多需要的人!