Java实现将HTML文件与字符串转换为图片

更新时间：2025年08月31日 09:29:00 作者：Eiceblue

在 Java 开发中,我们经常会遇到将 HTML 内容转换为图片的需求,本文小编就来和大家详细讲讲如何使用 Free Spire.Doc for Java 库来实现这一功能吧

前言

在 Java 开发中，我们经常会遇到将 HTML 内容转换为图片的需求，比如生成网页报告截图、电商商品详情页预览图、在线文档缩略图等。本文将介绍如何使用 Free Spire.Doc for Java 库来实现这一功能。

Free Spire.Doc for Java 是一款免费库且无需任何依赖，有一定页面限制，适合中小型项目或个人开发者使用。在开始之前，将以下依赖项添加到您的pom.xml文件中：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.com/nexus/content/groups/public/</url>
    </repository>
</repositories>
<dependency>
    <groupId>e-iceblue</groupId>
    <artifactId>spire.doc.free</artifactId>
    <version>5.3.2</version>
</dependency>

核心实现：HTML 转图片完整代码

Free Spire.Doc for Java 实现 HTML 转图片的逻辑很清晰：先将 HTML 内容加载为 Document 文档对象，再通过saveToImages 方法将文档页面转换为图片流，最后输出为本地图片文件。以下是两种常见场景的完整代码：

场景 1：转换本地 HTML 文件为图片

如果需要转换的 HTML 已保存为本地文件（如input.html），代码如下：

import com.spire.doc.*;
import com.spire.doc.documents.*;

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;

public class HTMLtoImage {
    public static void main(String[] args) throws Exception{
        // 加载 HTML 文档
        Document document = new Document();
        document.loadFromFile("E:\\input.html", FileFormat.Html, XHTMLValidationType.None);

        // 将 HTML 文档转换为图片
        BufferedImage[] images = document.saveToImages(ImageType.Bitmap);

        // 遍历图片集合
        for (int i = 0; i < images.length; i++) {

            // 将图像保存为 png 格式
            BufferedImage image = images[i];
            File file = new File(String.format(("HTML转图-%d.png"), i));
            ImageIO.write(image, "PNG", file);
        }
    }
}

输出：

场景 2：转换 HTML 字符串为图片

若 HTML 内容是动态生成的字符串（如接口返回的 HTML 片段），无需保存为本地文件，可直接加载字符串转换：

import com.spire.doc.Document;
import com.spire.doc.documents.ImageType;
import com.spire.doc.documents.Paragraph;

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;

public class HtmlStringToImage {
    public static void main(String[] args) throws IOException {
            // 定义HTML字符串（可包含图片标签等）
            String htmlContent = "<!DOCTYPE html>" +
                    "<html>" +
                    "<head><style>" +
                    "body{font-family:Arial;}" +
                    ".title{color:#2E86AB;font-size:24px;}" +
                    ".content{margin-top:20px;line-height:1.8;}" +
                    "</style></head>" +
                    "<body>" +
                    "<h1 class='title'> Java HTML字符串转图片</h1>" +
                    "<div class='content'>这是一个HTML字符串转图片的测试案例。</div>" +
                    "<img src='E:\\data.jpg' width='300' height='200'/>" +
                    "</body></html>";

            // 创建Document对象，写入HTML字符串
            Document document = new Document();
            Paragraph paragraph = document.addSection().addParagraph();
            paragraph.appendHTML(htmlContent);

            // 转换为图片并保存
            BufferedImage[] images = document.saveToImages(ImageType.Bitmap);
            for (int i = 0; i < images.length; i++) {

                // 将图像保存为 png 格式
                BufferedImage image = images[i];
                File file = new File(String.format(("HTML字符串转图.png"), i));
                ImageIO.write(image, "PNG", file);

        }
    }
}

输出：

关键参数说明

为了让转换效果更符合需求，这里补充几个关键参数的调整技巧和注意事项：

图片格式选择：PNG 支持透明背景且无损压缩，适合文字类内容；JPG 压缩率高，适合含图片的 HTML（可通过ImageIO.write 调整图片格式）。
HTML 兼容性注意事项：图片路径需使用绝对路径（如C:\\test.jpg 或 http://xxx.com/test.jpg），相对路径可能导致图片加载失败。
多页 HTML 处理：若 HTML 内容超过 1 页，saveToImages 方法会返回一个 BufferedImage 数组，每个元素对应 1 页图片，可通过循环遍历保存所有页面。

通过 Free Spire.Doc for Java 实现 HTML 转图片，代码简洁且无额外依赖，非常适合快速集成到项目中。除了 HTML 转图片，该免费 Java 库还支持更多Word文档处理功能。

到此这篇关于Java实现将HTML文件与字符串转换为图片的文章就介绍到这了,更多相关Java HTML转图片内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Spring boot打包jar分离lib和resources方法实例
这篇文章主要介绍了Spring boot打包jar分离lib和resources方法实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-05-05
springboot与redis的简单整合实例
Redis是一个缓存、消息代理和功能丰富的键值存储。StringBoot提供了基本的自动配置。这篇文章主要介绍了springboot与redis的简单整合实例，非常具有实用价值，需要的朋友可以参考下
2019-01-01
java链表应用--基于链表实现队列详解（尾指针操作）
这篇文章主要介绍了java链表应用--基于链表实现队列,结合实例形式分析了java基于链表实现队列尾指针相关操作使用技巧,需要的朋友可以参考下
2020-03-03
java 记录一个子串在整串中出现的次数实例
今天小编就为大家分享一篇java 记录一个子串在整串中出现的次数实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-07-07
关于使用Lambda表达式简化Comparator的使用问题
这篇文章主要介绍了关于使用Lambda表达式简化Comparator的使用问题,文中图文讲解了Comparator对象的方法,需要的朋友可以参考下
2023-04-04
Spring Boot调用 Shell 脚本实现看门狗功能
这篇文章主要介绍了Spring Boot调用 Shell 脚本实现看门狗功能,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-06-06
教你怎么用Java回溯算法解数独
一直不太会数独问题,这次下决定搞明白,所以整理了本篇文章,文中有非常详细的代码示例,对不会算法的小伙伴们很有帮助,需要的朋友可以参考下
2021-06-06
maven 离线模式打包的实现示例
本文主要介绍了在不使用外网的情况下进行离线打包,步骤包括删除远程仓库文件、打包本地依赖、修改Maven配置文件并执行命令,具有一定的参考价值,感兴趣的可以了解一下
2026-01-01
让IntelliJ IDEA支持.vue文件的方法
这篇文章主要介绍了让IntelliJ IDEA支持.vue文件的方法,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-05-05
Java调用WebService服务的三种方式总结
虽然WebService这个框架已经过时,但是有些公司还在使用,在调用他们的服务的时候就不得不面对各种问题,本篇文章总结了最近我调用 WebService的心路历程,3种方式可以分别尝试,需要的朋友可以参考下
2023-08-08