birt引擎对html标准支持有限，`
- `等语义化属性在pdf渲染中被忽略，导致所有有序列表均从1开始编号；本文提供兼容性方案与实用替代方法。
在使用BIRT生成PDF报表时，开发者常期望通过标准HTML语法控制有序列表起始编号，例如：
<ol start="2"> <li>第二项内容</li> <li>第三项内容</li> </ol>
然而，BIRT的PDF渲染引擎（基于Apache FOP或内置PDF生成器）并不解析start、reversed、type等<ol>标签的HTML5属性——它仅将<ol>视为“带数字前缀的块级容器”，并始终从1开始自动递增编号。该行为并非Bug，而是设计使然：BIRT定位为报表工具而非浏览器引擎，其HTML支持仅限于基础文本格式化（如<b>、<i>、<font>、内联CSS颜色/字体），不包含列表语义、表单控件或脚本交互。
✅ 可行解决方案如下：
1. 使用静态编号 + <p> 替代 <ol>（推荐）
完全绕过<ol>标签，用纯文本模拟编号逻辑，确保PDF与HTML一致：
<p>1. List Item 1</p> <p>2. Some text for list item 2</p> <p>3. And so on...</p>
若需动态编号（如数据绑定），可在BIRT表达式中拼接：
// 在Dynamic Text元素中设置Content Type = HTML，Expression: "<p>" + (row["index"] + 1) + ". " + row["description"] + "</p>"
2. 利用BIRT List组件 + 计数器（结构化方案）
- 删除HTML中的<ol>，改用BIRT原生List元素；
- 在List Detail行中插入两个Text元素：
• 第一个Text：表达式 "" + (this.getListIndex() + 2) （假设从2开始）
• 第二个Text：绑定数据字段（如row["content"]）； - 设置两者为行内布局（Horizontal Alignment → Left），用 或Tab分隔。
3. CSS伪元素（仅对HTML预览有效，PDF无效）
以下CSS在HTML预览中可生效，但PDF导出时被完全忽略，不建议依赖：
ol.custom-start { counter-reset: item 1; } /* 无法影响PDF */
li { display: block; }
li:before { content: counter(item) ". "; counter-increment: item; }⚠️ 重要注意事项：
- BIRT的PDF导出器不执行JavaScript、不解析CSS计数器、不识别HTML5语义属性；
- 所有“样式优先”思路（如外部CSS导入、style属性覆盖）均无法修复start属性缺失问题；
- 若项目强依赖HTML/CSS一致性，建议将BIRT用于数据聚合与分页，前端用Puppeteer或WeasyPrint等现代工具生成PDF。
综上，面对BIRT的HTML支持边界，应以声明式数据驱动替代声明式HTML标记——用BIRT表达式或List组件显式控制序号，而非寄望于HTML属性自动生效。这是保障PDF输出稳定、可维护的核心实践。
