JavaScript实现HTML指定区域截图与下载功能

作者:竹影时间:2026-10-22 09:18:04浏览:374

本文介绍如何利用html2canvas库在前端实现指定HTML模块的截图功能。通过引入必要JS与CSS文件,结合DOM操作将Canvas转换为图片并生成下载链接,兼容IE及其他现代浏览器,实现点击按钮即触发图片保存。

前端截图功能概述

当需要在HTML页面中实现特定模块的截图并具备保存图片功能时,在前台直接生成截图文件并提供下载接口会更为便捷。以下直接展示具体实现方案。

环境配置与样式准备

首先,项目中需要引入两个必要的JavaScript库文件:


 <script type="text/javascript" src="js/html2canvas.js"></script>
 <script type="text/javascript" src="js/jquery-1.12.3.min.js"></script>

接着添加CSS样式,主要用于生成表示“X”的关闭图标:


body{background: #ccc}
#dw{position: absolute;top: 10px;left:10%;height: 620px;width:1030px;background: #fff; border:1px solid black;padding: 10px}
.close{
 position:relative;
 left: 10px;
 width:0.2em;
 height:1em;
 background: #333;
 -webkit-transform: rotate(45deg);
 -moz-transform: rotate(45deg);
 -o-transform: rotate(45deg);
 -ms-transform: rotate(45deg);
 transform: rotate(45deg);
 display: inline-block;
}
.close:after{
 content: "";
 position: absolute;
 top: 0;
 left: 0;
 width:0.2em;
 height:1em;
 background: #333;
 -webkit-transform: rotate(270deg);
 -moz-transform: rotate(270deg);
 -o-transform: rotate(270deg);
 -ms-transform: rotate(270deg);
 transform: rotate(270deg);
}

HTML结构与交互设计

编写一个基础的Div模块,并在其中放置一个用于触发截图操作的按钮,位置可根据实际需求调整。


<!-- 要截图的div main 蓝色区域 -->
<div id="main" style="width: 50%; margin-left: 100px;padding: 50px;height: 400px;background: #5a90a0">
  <div style="height: 200px;width: 200px;background: #ccc;"></div>
  <div style="height: 30px;width: 168px;border:2px solid black;background: red;text-align: center;" onclick="doScreenShot()">截图</div>
</div>
<!-- 生成图片展示的DIV dw-->
<div id="dw" >
  <div style="float: right;width: 25px;height: 25px;" title="关闭" onclick="closeok()">
    <span class="close"></span>
  </div> 
</div>

页面渲染后的效果如下所示:

前端截图功能概述

JavaScript核心实现逻辑

具体的JavaScript实现代码如下:


$("#dw").hide();
//关闭图片
function closeok(){
 $("#dw").hide();
}
//点击截图
function doScreenShot(){
 $("#dw").show();
 html2canvas($("#main"), {
  onrendered: function(canvas) {
   canvas.id = "mycanvas"; 
   var mainwh=$("#main").width(); 
   var mainhg=$("#main").height();
   var img = convertCanvasToImage(canvas);
   console.log(img);
   //document.body.appendChild(img);
   $("#dw").append(img) //添加到展示图片div区域
   img.onload = function() {
    img.onload = null;
    canvas = convertImageToCanvas(img, 0, 0, 1024, 600); //设置图片大小和位置
    img.src = convertCanvasToImage(canvas).src;
    $(img).css({
     background:"#fff"  
    });
    //调用下载方法 
     if(browserIsIe()){ //假如是ie浏览器    
      DownLoadReportIMG(img.src);
     }else{
      download(img.src)
     }
    }
   }    
 });
} 
//绘制显示图片 
function convertCanvasToImage(canvas) {
 var image = new Image();
 image.src = canvas.toDataURL("image/png"); //获得图片地址
 return image;
}
//生成canvas元素,相当于做了一个装相片的框架
function convertImageToCanvas(image, startX, startY, width, height) {
 var canvas = document.createElement("canvas");
 canvas.width = width;
 canvas.height = height;
 canvas.getContext("2d").drawImage(image, startX, startY, width, height, 20, 20, 960, 600); //在这调整图片中内容的显示(大小,放大缩小,位置等)
 return canvas;
}
 function DownLoadReportIMG(imgPathURL) {
 //如果隐藏IFRAME不存在,则添加
 if (!document.getElementById("IframeReportImg"))
  $('<iframe style="display:none;" id="IframeReportImg" name="IframeReportImg" onload="DoSaveAsIMG();" width="0" height="0" src="about:blank"></iframe>').appendTo("body");
 if (document.all.IframeReportImg.src != imgPathURL) {
  //加载图片
  document.all.IframeReportImg.src = imgPathURL;
 }
 else {
  //图片直接另存为
  DoSaveAsIMG();
 }
}
function DoSaveAsIMG() {
 if (document.all.IframeReportImg.src != "about:blank")
  window.frames["IframeReportImg"].document.execCommand("SaveAs");
}
// 另存为图片
function download(src) {
 var $a = $("<a></a>").attr("href", src).attr("download", "img.png");
 $a[0].click();
}
//判断是否为ie浏览器
function browserIsIe() {
 if (!!window.ActiveXObject || "ActiveXObject" in window)
  return true;
 else
  return false;
}

代码解析:这里实现核心截图功能的关键在于调用

html2canvas(dom, {  onrendered: function(canvas) {})方法,该方法是插件提供的接口。参数dom代表需要被截图的DOM元素模块。

该方法的作用是将生成的canvas对象转换为img图片元素,其内部调用了单独的convertCanvasToImage()方法来完成转换。

其中,image.src = canvas.toDataURL("image/png");这行代码用于生成图片的URL地址。该地址指向截取的元素图像,获取到图片地址后即可进行后续处理。此处仅将图片添加到id为“dw”的元素中以展示效果。实际上,完成图片生成即可满足基本需求,但为了演示,代码中额外使用canvas进行了封装。

随后定义了图片加载完成后的onload方法,在其中设置属性并自动执行下载逻辑。下载方法区分了IE浏览器(采用网上通用的兼容方案)以及现代浏览器的直接生成下载方式。关于下载实现有多种方案,可根据项目需求选择。

此外,自定义的download(src)下载方法同样适用于IE浏览器,因为其原理简单,即通过动态生成元素并触发点击事件来实现。

功能总结

总结

以上介绍了使用JavaScript实现Div模块截图并下载的功能,希望这对大家有所帮助。如有疑问欢迎留言,小编会及时回复。感谢对本站的支持!

作者最新文章