domtoimage -- html转化为图片

html转化为图片

前言

这段时间的工作中,一直在做canvas类的H5,开发的过程中很关键的一部分是将dom节点转化为图片。起初是用html2canvas来做的,做完之后感觉图片清晰度的效果不是很好,然后就再GitHub上找到 domtoimage这个js插件换了之前html2canvas。更换后不仅清晰度有所提高,能够支持的图片格式和dom节点样式也比html2canvas要多。

简洁的domtoimage

domtoimage 主要代码才700多行,方法和属性都比较少,下载之后看一下就知道怎么用,有些什么功能。虽然html2canvas 代码3000多行,调用其实也是不难,但相对来说代码确实比domtoimage多了很多。

domtoimage 主要的方法有:

domtoimage.toPng(...);将节点转化为png格式的图片


var node = document.getElementById('my-node');

domtoimage.toPng(node)
    .then(function (dataUrl) {
        var img = new Image();
        img.src = dataUrl;
        document.body.appendChild(img);
    })
    .catch(function (error) {
        console.error('oops, something went wrong!', error);
    });
复制代码

domtoimage.toJpeg(...);将节点转化为jpg格式的图片

domtoimage.toJpeg(document.getElementById('my-node'), { quality: 0.95 })
    .then(function (dataUrl) {
        var link = document.createElement('a');
        link.download = 'my-image-name.jpeg';
        link.href = dataUrl;
        link.click();
    });
复制代码

domtoimage.toSvg(...);将节点转化为svg格式的图片,生成的图片的格式都是base64格式。

function filter (node) {
    return (node.tagName !== 'i');
}

domtoimage.toSvg(document.getElementById('my-node'), {filter: filter})
    .then(function (dataUrl) {
        /* do something */
    });
复制代码

domtoimage.toBlob(...);将节点转化为二进制格式,这个可以直接将图片下载,是不是非常方便

domtoimage.toBlob(document.getElementById('my-node'))
    .then(function (blob) {
        window.saveAs(blob, 'my-node.png');
    });
复制代码

domtoimage.toPixelData(...);获取原始像素值,以Uint8Array 数组的形式返回,每4个数组元素表示一个像素点,即rgba值。这个方法也是挺实用的,可以用于WebGL中编写着色器颜色。

var node = document.getElementById('my-node');

domtoimage.toPixelData(node)
    .then(function (pixels) {
        for (var y = 0; y < node.scrollHeight; ++y) {
          for (var x = 0; x < node.scrollWidth; ++x) {
            pixelAtXYOffset = (4 * y * node.scrollHeight) + (4 * x);
            /* pixelAtXY is a Uint8Array[4] containing RGBA values of the pixel at (x, y) in the range 0..255 */
            pixelAtXY = pixels.slice(pixelAtXYOffset, pixelAtXYOffset + 4);
          }
        }
    });
复制代码

domtoimage 主要的属性有:

filter : 过滤器节点中默写不需要的节点;

bgcolor : 图片背景颜色;

height, width : 图片宽高;

style :传入节点的样式,可以是任何有效的样式;

quality : 图片的质量,也就是清晰度;

cacheBust : 将时间戳加入到图片的url中,相当于添加新的图片;

imagePlaceholder : 图片生成失败时,在图片上面的提示,相当于img标签的alt;

上面的这些摘自 GitHub

domtoimage 和html2canvas 对比

兼容更多的样式和标签

在我做的那个H5中,节点不仅包含有渐变,滤镜,阴影等比较难渲染的样式,还包含有各种svg标签,同时svg具有描边和填充等属性。

dome

两者都是直接调用借口没进行任何处理,通过对比可以看出,domtoimage比html2canvas多了能够兼容滤镜,阴影(box-shadow)等样式,能够更好的支持svg。

生成的图片比较清晰

同样用最简单的方法调用两个方法生成图片,能够看得出通过domtoimage生成出来的图片明显的比html2canvas要清晰很多

稍微放大后对比,就能非常清楚的看出差别

dome

domtoimage不足点

domtoimage也不是所有的样式都能够兼容,到目前为止我发现的兼容不了的属性有,图形遮罩mask-box-image,和svg 的阴影drop-shadow。因为项目所需,所自己处理了图形遮罩的兼容问题,而svg阴影drop-shadow,实在是有点难度,暂时也就放置了。图形遮罩的兼容代码在下面第二个dome中。这里就不多讲了

dome 直接用domtoimage 无法正常生存图片

dome 后期处理后可生存图片

总结

domtoimage 性能还是很不错,优于html2canvas,代码少,性能高,应用简单。

如果有其他好用的插件,或编写有错的地方欢迎留言赐教,谢谢!

转载于:https://juejin.im/post/5a661ed0f265da3e5234a356

你可能感兴趣的:(domtoimage -- html转化为图片)