BIRT报表中有序列表（OL）的start属性在PDF导出时失效的解决方案

birt引擎对html标准支持有限，`

`等语义化属性在pdf渲染中被忽略，导致所有有序列表均从1开始编号；本文提供兼容性方案与实用替代方法。

在使用BIRT生成pdf报表时，开发者常期望通过标准html语法控制有序列表起始编号，例如：

   
第二项内容
   
第三项内容
 

然而，BIRT的PDF渲染引擎（基于apache FOP或内置PDF生成器）并不解析start、reversed、type等

标签的html5属性

——它仅将

视为“带数字前缀的块级容器”，并始终从1开始自动递增编号。该行为并非bug，而是设计使然：BIRT定位为报表工具而非浏览器引擎，其HTML支持仅限于基础文本格式化（如、、、内联css颜色/字体），不包含列表语义、表单控件或脚本交互。

✅ 可行解决方案如下：

1. 使用静态编号 +

替代

（推荐）


完全绕过

标签，用纯文本模拟编号逻辑，确保PDF与HTML一致：

1. List Item 1
 
2. Some text for list item 2
 
3. And so on...

若需动态编号（如数据绑定），可在BIRT表达式中拼接：

// 在Dynamic Text元素中设置Content Type = HTML，Expression: "
" + (row["index"] + 1) + ". " + row["description"] + "
"

2. 利用BIRT List组件 + 计数器（结构化方案）

• 删除HTML中的
  ，改用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输出稳定、可维护的核心实践。