html2canvas的踩坑之路

Dear 丶 2022-04-25 00:12 564阅读 0赞

## 前言 ##

早有耳闻这个[html2canvas][]比较坑,但无奈于产品需求的压迫,必须实现html转图片的功能,自此走上了填坑之路,好在最后的效果还算令人满意,这才没有误了产品上线周期.

### html2canvas介绍 ###

`html2canvas`的详细介绍可以点击[这里][Link 1]查看,其实简单来说就是通过`canvas`将`HTML`生成的`DOM`节点绘制到画布上,再可以通过自己的需求转换成图片.所以官方文档也说了,最后生成的效果不是100%相同的,这一点大家要有心理准备,无论怎样,一点点小瑕疵是肯定有的。

### 兼容性 ###

![6d5997a4ea3bfca89007b1df220581106db44700][]

PS: **微信浏览器**使用也是没有问题的哦

### 使用html2canvas ###

使用也是十分简单,官网写的很清楚[戳这里][Link 2]

## 踩坑过程 ##

### 生成的图片里面为什么缺失微信头像或其他图片? ###

其实涉及到的就是**跨域**问题,即便是canvas的画布中对于图片的域也是有要求的,那我们应该怎么解决呢?

1.  `html2canvas`的[配置项][Link 3]中配置 `allowTaint:true` 或 `useCORS:true`(二者不可共同使用)
2.  img标签增加 `crossOrigin='anonymous'`
3.  图片服务器配置`Access-Control-Allow-Origin` 或使用代理

其中第三步是最重要的,不设置则前两步设置了也无效。

服务器需要配置`Access-Control-Allow-Origin`信息,如PHP添加响应头信息，\*通配符表示允许任意域名：

header("Access-Control-Allow-Origin: *");

或者指定域名：

header("Access-Control-Allow-Origin: www.zhangxinxu.com");

但如果不想麻烦后端的人员,那我们前端怎么跨域呢? 那就可以使用代理插件,如:  [html2canvas-proxy-nodejs][]  或者是  [superagent][] ，我是使用 `superagent` ,贴一下示例代码:

const request = require('superagent') // 导入
    const proxHost = 'https://thirdwx.qlogo.cn' // 指定跨域图片的地址
    app.use('/proxy', function (req, res, next) {
      let urlPath = req.url
      console.log('urlPath', urlPath)
      urlPath = decodeURI(urlPath)
      if (!urlPath) {
        console.log('urlPath is null')
        return next()
      }
      console.log('proxy-request: /proxy->' + `${proxHost}${urlPath}`)
      const reqStream = request.get(`${proxHost}${urlPath}`)
      reqStream.on('error', function (err) {
        console.log('error', err)
      })
      console.log('------reqStream----')
      return reqStream.pipe(res)
    })

那么最终我在页面中的图片的src `https://thirdwx.qlogo.cn/xxx`  要更改为 `/proxy/xxx`  效果图如下:

![232989cf00ddbdaa4240e93eae9e219214db8622][]

![7fb316933c2875d0c28b81e9ea3f3984a71da16d][]

### 2.生成的图片模糊不清且有锯齿瑕疵怎么办? ###

大部分找到的结果都是使用设备像素比去操作,但实际使用起来,还是会有锯齿。 这个问题苦恼了我很久,并且找了很久的相关资料,总算是功夫不负有心人,让我找到了解决方案,在github里有大神已经提供了解决方案,可以点击[这里][Link 4],大神在源码的基础上增加两个配置项,`scale`和`dpi`,推荐使用`scale`参数。

源码位置:`https://github.com/eKoopmans/html2canvas/tree/develop/dist`

let imgHeight = window.document.querySelector('.content').offsetHeight // 获取DOM高度
            let imgWidth = window.document.querySelector('.content').offsetWidth // 获取DOM宽度
            let scale = window.devicePixelRatio // 获取设备像素比
            html2canvas(window.document.querySelector('.content'), {
                useCORS: true,
                scale: scale,
                width: imgWidth,
                height: imgHeight
            }).then((canvas) => {
              window.document.querySelector('.content').remove()
              let elemImg = `<img src='${canvas.toDataURL('image/png')}' id='canvas-img' style='height: ${imgHeight}px;border-radius: 10px;width:${imgWidth}px'/>`
              window.document.querySelector('.container').innerHTML = elemImg
            })

最终生成出来的图片,是清晰并且最接近`DOM`的图片

### 3.生成的图片中若包含二维码,微信长按图片偶现无法识别? ###

![7168b741b2b2b9cb510f2f11dbd0a18184dbcb66][]

这个问题主要出现在使用单页面框架(如VUE)的页面. 感谢  [sundaypig][] 提出的解决方案。 很简单,就是不使用路由切换,使用 `window.location.href` 直接跳转刷新页面

location.href="www.abc.com/share/xxx"

PS:这个问题可以解决所有页面中偶现二维码无法识别的情况

### 4.生成的图片中文字间距较大? ###

这个暂时无法完美解决,可以尝试用css属性:`letter-spacing`来设置字间距。

原文发布时间为：2018年06月27日

原文作者：Anonlyyy

本文来源： [掘金][Link 5] 如需转载请联系原作者

[html2canvas]: https://link.juejin.im?target=https%3A%2F%2Fhtml2canvas.hertzen.com%2F
[Link 1]: https://link.juejin.im?target=https%3A%2F%2Fhtml2canvas.hertzen.com%2Fdocumentation
[6d5997a4ea3bfca89007b1df220581106db44700]: /images/20220210/930015215ebb4c1296c03e0f1855f4af.png
[Link 2]: https://link.juejin.im?target=http%3A%2F%2Fhtml2canvas.hertzen.com%2Fgetting-started
[Link 3]: https://link.juejin.im?target=https%3A%2F%2Fhtml2canvas.hertzen.com%2Fconfiguration
[html2canvas-proxy-nodejs]: https://link.juejin.im/?target=https%3A%2F%2Fgithub.com%2Fniklasvh%2Fhtml2canvas-proxy-nodejs
[superagent]: https://link.juejin.im/?target=http%3A%2F%2Fvisionmedia.github.io%2Fsuperagent%2F
[232989cf00ddbdaa4240e93eae9e219214db8622]: /images/20220210/78f1056669db42b29a862f2d2b6cd68e.png
[7fb316933c2875d0c28b81e9ea3f3984a71da16d]: /images/20220210/998807e2ebd04f798ab18797159984bd.png
[Link 4]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fniklasvh%2Fhtml2canvas%2Fpull%2F1087
[7168b741b2b2b9cb510f2f11dbd0a18184dbcb66]: /images/20220210/04299dad5fd94a32990e2ab6e4b107d6.png
[sundaypig]: https://link.juejin.im/?target=https%3A%2F%2Fgithub.com%2Fsundaypig
[Link 5]: https://juejin.im/post/5b31d98ee51d4558817e14f8