如何在iText/pdfHtml中使用page属性？命名页面规则失效求助

我之前也碰到过类似的问题——iText对CSS里的page属性支持确实不完整，虽然你能看到解析器正确识别了命名页面的规则，但实际渲染时就是不会把元素的page属性和对应的页面设置关联起来，这属于当前版本的功能局限。

可行的替代方案 #

既然原生CSS绑定走不通，咱们可以通过iText的API手动控制页面属性，达到同样的效果：

1. 直接切换页面参数
   在渲染特定元素（比如你例子里的div或table）之前，手动修改文档的页面尺寸或方向：

   // 初始化文档为窄页面（对应9cm×18cm，和A6尺寸接近）
   PdfDocument pdfDoc = new PdfDocument(new PdfWriter("output.pdf"));
   Document doc = new Document(pdfDoc, PageSize.A6);
   
   // 渲染应用narrow规则的div内容
   doc.add(new Paragraph("这是窄页面上的内容"));
   
   // 切换到横向页面
   doc.setPageSize(PageSize.A4.rotate());
   // 渲染应用rotated规则的表格
   Table table = new Table(2);
   table.addCell("单元格1");
   table.addCell("单元格2");
   doc.add(table);
   
   doc.close();
   

2. 用页面事件处理器实现动态切换
   如果需要根据元素类型自动适配页面，自定义页面事件处理器会更灵活：

   class CustomPageSwitcher extends PdfPageEventHelper {
       private PageSize targetSize;
       
       public void setTargetPageSize(PageSize size) {
           this.targetSize = size;
       }
       
       @Override
       public void onStartPage(PdfWriter writer, Document document) {
           if (targetSize != null) {
               document.setPageSize(targetSize);
           }
       }
   }
   
   // 使用示例
   PdfWriter writer = new PdfWriter("output.pdf");
   PdfDocument pdfDoc = new PdfDocument(writer);
   CustomPageSwitcher pageSwitcher = new CustomPageSwitcher();
   pdfDoc.addEventHandler(PdfDocumentEvent.START_PAGE, pageSwitcher);
   Document doc = new Document(pdfDoc);
   
   // 渲染窄页面前设置尺寸
   pageSwitcher.setTargetPageSize(PageSize.A6);
   doc.add(new Paragraph("窄页面内容"));
   
   // 渲染横向表格前切换尺寸
   pageSwitcher.setTargetPageSize(PageSize.A4.rotate());
   doc.add(new Table(2).addCell("横向表格").addCell("示例"));
   
   doc.close();
   

关于原生CSS支持的说明 #

iText的CSS解析器确实能解析@page命名规则和page属性，但它的布局引擎并没有实现把元素的page属性映射到对应页面设置的逻辑——这是个部分完成的功能，目前官方还没有明确的时间表来完善它。

如果你的项目必须依赖CSS定义页面规则，可能需要等iText后续版本更新；暂时的话，用上面的API手动控制是最可靠的解决办法。

内容的提问来源于stack exchange，提问作者Zuzu_Typ