本文旨在解决在 jtextpane 中使用 html 显示图片时，由于相对路径问题导致图片无法加载的问题。我们将探讨相对 url 的概念，并提供两种解决方案：一是通过设置 htmldocument 的 base url，二是不使用 html，而是直接使用 java 代码创建组件，加载并显示图片。
在使用 `JTextPane` 显示包含图片的 HTML 内容时，如果图片无法正常加载，很可能是由于 HTML 中的图片路径是相对路径，而 `JTextPane` 无法正确解析这些相对路径。 本文将详细介绍这个问题的原因，并提供两种解决方案。 ### 问题分析：相对 URL 和 Base URL 当 HTML 代码中使用 `src="icons/roles/seer_icon.png"` 这样的图片路径时，这实际上是一个**相对 URL**。相对 URL 的实际位置取决于 HTML 文档的 **Base URL**。 * 如果 HTML 内容是通过 `setPage` 方法从一个 URL 加载的，那么这个 URL 就作为 Base URL。 * 如果 HTML 内容是从字符串加载的（比如从 properties 文件读取），那么默认情况下没有 Base URL。 这意味着 `src="icons/roles/seer_icon.png"` 无法被正确解析，因为系统不知道 `icons/roles/seer_icon.png` 相对于哪个目录。 ### 解决方案一：设置 HTMLDocument 的 Base URL 为了解决这个问题，我们可以手动设置 `HTMLDocument` 的 Base URL。 这样，`JTextPane` 就能正确解析 HTML 中的相对路径。 以下是示例代码： ```java JTextPane textPane = new JTextPane(); textPane.setContentType("text/html"); textPane.setText("
");
HTMLDocument doc = (HTMLDocument) textPane.getStyledDocument();
try {
doc.setBase(MyApplication.class.getResource("/")); // 设置 Base URL 为根目录
} catch (IOException e) {
e.printStackTrace();
}代码解释：
- 首先，我们创建了一个 JTextPane 并设置内容类型为 "text/html"。
- 然后，我们获取 JTextPane 的 StyledDocument 并将其强制转换为 HTMLDocument。
- 关键的一步是使用 doc.setBase(MyApplication.class.getResource("/")) 设置 Base URL。 MyApplication.class.getResource("/") 获取的是当前类所在的根目录的 URL。 请根据你的实际项目结构修改此路径。
- 最后，确保将 icons/roles/seer_icon.png 放置在正确的相对路径下（相对于根目录）。
注意事项：
- 确保 icons/roles/seer_icon.png 文件存在于类路径的根目录下，或者根据你的项目结构调整 getResource 方法的参数。
- IOException 需要进行适当的异常处理。
解决方案二：直接使用 Java 代码创建组件
如果 HTML 内容比较简单，并且主要是为了显示文本和图片，那么可以考虑不使用 HTML，而是直接使用 Java 代码创建 JLabel 和 JPanel 等组件，并手动加载和显示图片。 这种方法更加灵活，也更容易控制。
以下是示例代码：
立即学习“前端免费学习笔记（深入）”；
// 假设 properties 文件包含：
// text=Seer:
// icon=/icons/roles/seer_icon.png
String headingText = "Seer:"; //properties.getProperty("text");
String iconPath = "/icons/roles/seer_icon.png"; //properties.getProperty("icon");
JLabel headingLabel = new JLabel(headingText);
Font font = headingLabel.getFont();
font = font.deriveFont(24f);
headingLabel.setFont(font);
headingLabel.setBorder(BorderFactory.createEmptyBorder(0, 0, 12, 0));
Icon icon = new ImageIcon(MyApplication.class.getResource(iconPath));
JLabel iconLabel = new JLabel(icon);
JPanel content = new JPanel(new BorderLayout());
content.add(headingLabel, BorderLayout.PAGE_START);
content.add(iconLabel, BorderLayout.CENTER);代码解释：
- 从 properties 文件中读取文本和图片路径。
- 创建一个 JLabel 用于显示文本，并设置字体和边框。
- 使用 ImageIcon 加载图片，并创建一个 JLabel 用于显示图片。
- 创建一个 JPanel，使用 BorderLayout 布局，将文本 JLabel 放在顶部，图片 JLabel 放在中心。
优点：
- 更加灵活，可以精确控制组件的样式和布局。
- 避免了 HTML 解析的复杂性。
- 更容易处理图片加载错误。
缺点：
- 需要编写更多的 Java 代码。
- 不适合显示复杂的 HTML 内容。
总结
当在 JTextPane 中使用 HTML 显示图片时，如果图片无法加载，通常是由于相对路径问题导致的。 可以通过设置 HTMLDocument 的 Base URL 或者直接使用 Java 代码创建组件来解决这个问题。 选择哪种方案取决于 HTML 内容的复杂度和项目的具体需求。 如果 HTML 内容比较简单，建议使用第二种方案，因为它更加灵活和易于控制。 如果 HTML 内容比较复杂，并且需要保留 HTML 的格式，那么可以使用第一种方案，但需要确保正确设置 Base URL。
