移动端H5页面截图【含 domtoimage、html2canvas 】

最新推荐文章于 2025-10-17 09:39:45 发布

原创最新推荐文章于 2025-10-17 09:39:45 发布 · 2.7w 阅读

21 ·

CC 4.0 BY-SA版权

文章标签：

#canvas #截图 #html2canvas #domtoimage #H5截图

react 专栏收录该内容

7 篇文章

订阅专栏

本文介绍了在移动端H5页面中进行截图的两种工具——html2canvas和domtoimage，讨论了它们的优缺点及在手机淘宝的兼容性问题，推荐在移动端使用WindVane的WVScreen.capture方法。文章提醒，如果不在移动端，使用SVG格式截图可以得到更高清的效果。

部署运行你感兴趣的模型镜像

起因：

由于云栖大会项目需要支持名片保存到本地功能【如下图红框】，所以，需要单独截取页面中的名片信息，并且保存到本地。

推荐给：需要获取页面内容，给页面截图的小伙伴

介绍两个工具：

html2canvas

官方地址：https://github.com/niklasvh/html2canvas

优点：

1.使用人数多，资料更全

缺点：

1.感觉不怎么维护更新了

domtoimage

官方地址【github例子很全了】：https://github.com/tsayen/dom-to-image

优点：

1.有人维护

2.git活跃，作者发言

3.使用方便

缺点：

1.新控件，使用人数少,资料不全

2.IOS手机不能截图，污染了canvas.toDataURL会报错【目前还没解决】（参考链接：https://github.com/tsayen/dom-to-image/issues/40）

报错信息如下："SECURITY_ERR: DOM Exception 18: The operation is insecure"

修改dom-to-image.js源码如下：

    //IOS兼容 
    function toPng(node, options) {
        return draw(node, options || {})
            .then(function(result) {
                try {
                    // 原来的
                    var image = result.canvas.toDataURL("image/png", 1.0);
                    return image;

                    // 改为svg更清楚
                    // console.log(result.svg.src);
                    // return result.svg.src;
                } catch (err) {
                    console.warn(err);
                    // alert(result.svg.src);
                    // console.log(result.svg.src);
                    return "error";
                }
            });
    }

最终方案选择：

参考了很多资料，最后决定IOS使用html2canvas ，Android使用domtoimage

代码：

  // 裁剪名片
  cropCard() {    
    let self = this;
    // 获取dom结构
    let card_target = this.refs.copyCardArea; 
    domtoimage.toPng(card_target).then(function(dataUrl) {
      //andriod 
      if (dataUrl != "error") {
        // alert("domtoimage");
        self.setState({
          imgUrl: dataUrl,
          isDownloadImg: true,
        })
      }
      // ios
      else {
        let b64;
        html2canvas(card_target, {
          useCORS: true
        }).then(function(canvas) {
          try {
            b64 = canvas.toDataURL("image/png");
          } catch (err) {
            console.log(err)
              // alert(err)
          }
          self.setState({
            imgUrl: b64,
            isDownloadImg: true,
          })
        }).catch(function onRejected(error) {});
      }
    });
  }

手机淘宝兼容：

手淘禁止了，用户使用截图，推荐使用官方JSBridge

WindVane链接：http://h5.alibaba-inc.com/api/WindVane-API.html

方法：WVScreen.capture

缺点：

1.只能截取整个屏幕，不能只获取名片信息

2.不知道是不是react的原因，直接使用，会有部分情况截取到灰色蒙版的效果，所以延迟300毫秒截图

引入：

    <script src="//g.alicdn.com/mtb/lib-windvane/2.1.8/windvane.js"></script>

代码：

      window.setTimeout(() => {
        this.taobaoCapture();
      }, 300);

  taobaoCapture() {
    let self = this;
    var params = {
      // 是否将截屏结果保存一份到相册中
      inAlbum: 'true'
    };
    window.WindVane.call('WVScreen', 'capture', params, function(e) {
      // alert('success: ' + JSON.stringify(e));
      // 截图成功提示话语
      self.setState({
        isTips: true,
        line1: tipWords.saveCardS.line1,
        line2: tipWords.saveCardS.line2,
      });
    }, function(e) {
      // alert('failure: ' + JSON.stringify(e));
      // 截图失败提示话语
      self.setState({
        isTips: true,
        line1: tipWords.saveCardF.line1,
        line2: tipWords.saveCardF.line2,
      });
    });
  }