本文目录导读：
针对您提到的 JEditorPane、HTMLEditorKit、Parser 以及“向下取整” 这几个关键词，我推测您可能是在使用 Java Swing 的 JEditorPane 解析/渲染 HTML 时，遇到了数值（特别是 CSS 中的百分比或像素值）被“向下取整” 的问题,并希望了解其原理或解决方案。
以下是针对这一场景的详细分析及解决方案。
问题背景：JEditorPane 的 HTML/CSS 解析特性
JEditorPane 配合 HTMLEditorKit 使用的是 Swing 自带的轻量级 HTML 解析器（HTMLDocument.HTMLReader 或旧的 ParserDelegator）。
这个解析器并非完整的浏览器引擎（如 WebKit 或 Gecko），它对 CSS 的支持有限，且在布局计算（Layout）阶段，对像素、百分比的计算往往会进行整数化（向下取整或四舍五入）。
为什么会有向下取整？
- Swing 组件模型基于整数坐标：
JComponent的所有setBounds()、setSize()等方法接受的参数都是int类型。 - 布局管理器限制：对于 HTML 表格、
<div>、图片等元素的宽度/高度计算，即使 CSS 中指定了width: 50.7%或height: 123.7px，解析器最终传递给 Swing 布局的数值必定是整数，通常采用截断（Truncation） 即向下取整（Math.floor的效果）。
最容易出现问题的场景
- 百分比宽度表格（
<table width="33.33%">）：总宽 100px 时，3 列应各为 33.33px，实际分配为 33px，剩余 1px 因向下取整导致右边出现空白或错位。 - CSS
font-size带小数：font-size: 10.5pt会被转为整数像素（如 14px -> 14）,导致字体比预期小或笔画重叠。 - 布局计算时子元素位置偏移：
margin-left: 10.5%-> 计算结果 10.5px -> 向下取整为 10px。
如何确认是向下取整（还是四舍五入）
您可以通过编写一个简单的测试来验证：
import javax.swing.*;
import javax.swing.text.html.*;
public class FloorTest {
public static void main(String[] args) {
JEditorPane editor = new JEditorPane("text/html",
"<html><body>"
+ "<table width='100' border='1'>"
+ "<tr><td width='33.33%'>A</td><td width='33.33%'>B</td><td>C</td></tr>"
+ "</table></body></html>");
// 添加一个 ComponentListener 来查看实际渲染尺寸
editor.addComponentListener(new java.awt.event.ComponentAdapter() {
public void componentResized(java.awt.event.ComponentEvent e) {
// 通过 Swing 的布局树查看实际分配宽度
// 通常看到的是 33, 33, 34 (因为最后一项占剩余)
System.out.println("First column actual width: "
+ editor.getDocument().getProperty("__some_debug_prop__"));
// 更直接的方法是自定义 View 并打印
}
});
JFrame frame = new JFrame();
frame.add(new JScrollPane(editor));
frame.setSize(400, 300);
frame.setVisible(true);
}
}
更准确的验证方式：覆盖 View 的 preferredSpan 方法（见下方解决方案 3）。
解决方案（针对不同需求）
方案 A：容忍向下取整（默认行为）
如果您的界面不依赖像素级精确度（例如普通文本显示），可以不做任何处理，Swing 的 HTML 渲染器从一开始就是基于整数布局的。
方案 B：强制使用四舍五入（通过修改 CSS 或百分比策略）
- 避免百分比的小数位：将 33.33% 改为 33% + 34% + 33%。
- 使用
width: 33.333px（带小数像素）：虽然最终会被截断，但如果您需要更精确的“按比例分配”，可以改用JEditorPane不支持但可计算的方式（见下）。
方案 C：自定义布局 View（最彻底）
如果您需要对 HTML 元素进行精确的布局（例如实现数学公式排版或像素级对齐），必须绕过默认的 View 实现：
import javax.swing.text.*;
import javax.swing.text.html.*;
import java.awt.*;
public class PrecisionView extends ParagraphView {
public PrecisionView(Element elem) {
super(elem);
}
@Override
protected int getColumnSpan() {
// 返回 float 值，但最终布局会调用 getPreferredSpan(int axis)
return super.getColumnSpan();
}
@Override
public float getPreferredSpan(int axis) {
float span = super.getPreferredSpan(axis);
// 这里不再向下取整，而是保持 float（但父类内部仍会转 int）
// 需要同时覆写 layout() 和 paint() 方法
return span;
}
// 注意：完全避免向下取整需要修改整个 View 树，工作量大。
// 建议：如果必须精确，使用非 Swing 的渲染器（如 JWebEngine 或 JavaFX WebView）。
}
方案 D：改用 JavaFX WebView（推荐）
如果精度要求高，且项目允许依赖 JavaFX：
import javafx.application.Platform;
import javafx.embed.swing.JFXPanel;
import javafx.scene.web.WebView;
import javafx.scene.Scene;
// 在 Swing 中嵌入 JavaFX
JFXPanel fxPanel = new JFXPanel();
Platform.runLater(() -> {
WebView webView = new WebView();
webView.getEngine().loadContent(
"<html><body><table width='100'><tr><td width='33.33%'>A</td>...</table></body></html>"
);
fxPanel.setScene(new Scene(webView));
});
// 将 fxPanel 加入 JFrame
JavaFX 的 WebView 基于 WebKit,完全支持浮点数布局。
| 场景 | 原因 | 推荐方案 |
|---|---|---|
| 普通显示，容许几像素偏差 | Swing 布局采用整数 | 不做处理 |
| 百分比表格、图片精确对齐 | 默认向下取整 | 方案 B：调整 HTML 百分比 或 方案 D：改用 WebView |
| 需要彻底避免向下取整 | View 类强制 int 布局 |
方案 C：自定义 View（复杂）或 方案 D |
核心结论：
JEditorPane + HTMLEditorKit 的解析器在布局阶段必然进行向下取整（因为 Swing 的坐标系统是整数），如果您确实需要精确的浮点布局，请考虑放弃使用 Swing 的 HTML 渲染，转而使用 JavaFX WebView 或 外部渲染器（如 Flying Saucer 对 PDF 输出）。
如果您提供具体的 HTML 代码片段（例如表格、图片或字体尺寸）,我可以给出更精确的调整建议。
