本文针对 `JTextPane` 中使用 HTML 显示图片时，图片无法加载的问题，深入剖析了相对 URL 的概念以及 `HTMLDocument` 的 `setBase` 方法的作用。同时，提供了使用 `JLabel` 和 `ImageIcon` 替代 HTML 的解决方案，帮助开发者更灵活地展示富文本内容。
在使用 JTextPane 显示包含图片的 HTML 内容时，如果图片无法正常加载，通常是因为 HTML 中使用了相对 URL，而 JTextPane 无法正确解析这些相对路径。 本文将详细介绍问题的原因和两种解决方案，帮助你解决 JTextPane 中 HTML 图片加载问题。
问题分析：相对 URL 与 Base URL
当 HTML 代码中的 标签的 src 属性使用相对 URL (例如 src="icons/roles/seer_icon.png") 时，浏览器或 JTextPane 需要一个基准 URL (Base URL) 来解析这个相对路径，从而找到图片的实际位置。
- 从 URL 加载 HTML: 如果使用 setPage 方法从一个 URL 加载 HTML 内容，那么该 URL 本身就会作为 Base URL。
- 从字符串加载 HTML: 如果像本例中一样，从字符串（例如从 properties 文件读取）加载 HTML 内容，那么默认情况下没有 Base URL。 这意味着 JTextPane 无法解析相对路径，导致图片无法显示。
解决方案一：设置 Base URL
解决此问题的一种方法是手动设置 HTMLDocument 的 Base URL。 通过 HTMLDocument 的 setBase 方法，可以指定一个 URL 作为解析相对路径的基准。
立即学习“前端免费学习笔记（深入）”；
示例代码：
import javax.swing.JTextPane;
import javax.swing.text.html.HTMLDocument;
import java.net.URL;
public class JTextPaneImageLoader {
public static void main(String[] args) throws Exception {
JTextPane textPane = new JTextPane();
textPane.setContentType("text/html");
// 从 properties 文件或其他来源获取 HTML 内容
String htmlContent = "Seer:
@@##@@";
textPane.setText(htmlContent);
// 获取 HTMLDocument 并设置 Base URL
HTMLDocument doc = (HTMLDocument) textPane.getStyledDocument();
// 假设 icons/roles/seer_icon.png 位于 resources 目录下
URL baseUrl = JTextPaneImageLoader.class.getResource("/");
doc.setBase(baseUrl);
// 在 GUI 中显示 textPane (省略 GUI 代码)
// ...
}
}代码解释：
- textPane.setContentType("text/html"); 设置 JTextPane 的内容类型为 HTML。
- textPane.setText(htmlContent); 将 HTML 内容设置到 JTextPane 中。
- HTMLDocument doc = (HTMLDocument) textPane.getStyledDocument(); 获取 JTextPane 的 HTMLDocument 对象。
- URL baseUrl = JTextPaneImageLoader.class.getResource("/"); 获取资源目录的 URL，作为 Base URL。 请确保 icons/roles/seer_icon.png 位于 resources 目录下。
- doc.setBase(baseUrl); 设置 HTMLDocument 的 Base URL。
注意事项：
- 确保 Base URL 指向包含图片资源的正确目录。
- 如果图片资源位于 JAR 包中，需要使用 getResource 方法获取 URL。
解决方案二：使用 JLabel 和 ImageIcon
如果不需要用户复制粘贴 HTML 内容，可以考虑使用 JLabel 和 ImageIcon 替代 HTML 来显示富文本内容。 这种方法更加灵活，并且可以避免 HTML 解析的一些问题。
示例代码：
import javax.swing.*;
import javax.swing.border.Border;
import java.awt.*;
import java.net.URL;
public class JLabelImageIconExample {
public static void main(String[] args) throws Exception {
// 从 properties 文件或其他来源获取文本和图片路径
String headingText = "Seer:";
String iconPath = "/icons/roles/seer_icon.png"; // 确保路径正确
// 创建 JLabel 显示文本
JLabel headingLabel = new JLabel(headingText);
Font font = headingLabel.getFont();
font = font.deriveFont(24f); // 设置字体大小
headingLabel.setFont(font);
headingLabel.setBorder(BorderFactory.createEmptyBorder(0, 0, 12, 0)); // 设置边距
// 创建 JLabel 显示图片
URL imageUrl = JLabelImageIconExample.class.getResource(iconPath);
ImageIcon icon = new ImageIcon(imageUrl);
JLabel iconLabel = new JLabel(icon);
// 创建 JPanel 布局
JPanel content = new JPanel(new BorderLayout());
content.add(headingLabel, BorderLayout.PAGE_START);
content.add(iconLabel, BorderLayout.CENTER);
// 在 GUI 中显示 content (省略 GUI 代码)
JFrame frame = new JFrame("JLabel and ImageIcon Example");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.getContentPane().add(content);
frame.setSize(300, 200);
frame.setVisible(true);
}
}代码解释：
- 从 properties 文件或其他来源获取文本和图片路径。
- 创建 JLabel 显示文本，并设置字体和边距。
- 使用 ImageIcon 加载图片，并创建 JLabel 显示图片。
- 创建 JPanel 使用 BorderLayout 布局，将文本和图片添加到 JPanel 中。
- 将 JPanel 添加到 JFrame 中，显示 GUI。
注意事项：
- 确保图片路径正确。
- 可以使用 BorderLayout 或其他布局管理器来灵活地布局文本和图片。
总结
本文介绍了 JTextPane 中 HTML 图片无法加载的两种解决方案：设置 Base URL 和使用 JLabel 和 ImageIcon。 选择哪种方案取决于具体的需求和场景。 如果需要用户复制粘贴 HTML 内容，可以使用第一种方案； 如果不需要，可以使用第二种方案，它更加灵活和易于控制。 在实际开发中，应根据具体情况选择最合适的解决方案。
