birt引擎不支持html中`
- `等部分原生属性，导致pdf导出时有序列表始终从1开始编号；本文详解原因、替代方案及可落地的css+脚本修复方法。
BIRT（Business Intelligence and Reporting Tools）的渲染引擎并非完整HTML浏览器，其PDF生成模块基于Apache FOP（Formatting Objects Processor）实现，仅支持有限的HTML/CSS子集——<ol> 的 start 属性属于明确不被支持的特性之一。因此，即使HTML预览正常，PDF导出时所有<ol>均重置为默认起始值1，这是设计限制，而非配置错误。
✅ 推荐解决方案：使用CSS计数器（CSS Counters）
BIRT 4.8+ 版本支持基础CSS2.1计数器（counter-reset / counter-increment / counter()），可精准模拟start行为：
<style type="text/css">
.custom-ol {
counter-reset: item 1; /* 默认从1开始 */
}
.custom-ol.start-2 {
counter-reset: item 2; /* 关键：手动设为2 */
}
.custom-ol li {
counter-increment: item;
}
.custom-ol li::before {
content: counter(item) ". ";
font-weight: bold;
}
</style>
<ol class="custom-ol">
<li>List Item 1</li>
</ol>
<ol class="custom-ol start-2">
<li>Some text for list item 2</li>
</ol>⚠️ 注意事项： BIRT对::before伪元素支持较弱，建议将编号逻辑移至报表脚本中（更稳定）； 避免在样式中使用list-style-type: none后依赖伪元素——部分BIRT版本会忽略该组合； 若需多级嵌套，需为每级定义独立计数器（如counter-reset: level1 1 level2 1）。
✅ 替代方案：报表脚本动态控制（推荐用于复杂场景）
在BIRT设计器中，为每个<li>元素绑定onCreate事件，用JavaScript动态设置序号文本：
// 在列表项（li）的 onCreate 脚本中：
var ol = this.getParent(); // 获取父级 ol 元素
var startIndex = parseInt(ol.getAttribute("start")) || 1;
var siblings = ol.getChildren();
var index = 0;
for (var i = 0; i < siblings.length; i++) {
if (siblings[i].getElementType() === "li") {
if (siblings[i] === this) break;
index++;
}
}
this.getElement().textContent = (startIndex + index) + ". " + this.getElement().textContent.replace(/^\d+\.\s*/, "");此方式绕过HTML解析限制，直接操作DOM文本，兼容性最佳，适用于BIRT 4.3及以上版本。
总结
BIRT的PDF导出本质是“语义化排版转换”，而非HTML渲染。面对start属性失效问题，不应尝试强制注入CSS或修改FOP配置（无效且易引发崩溃），而应转向BIRT原生支持的CSS计数器或报表脚本方案。优先使用CSS计数器实现简单场景；对跨页、嵌套或动态数据列表，务必采用脚本控制——既保障可靠性，也符合BIRT工程化实践规范。
