如何在QuestPDF中实现跨页重复标题并添加续篇标识？

可以实现，QuestPDF的Section组件专门适配这种局部内容组跨页重复头部的场景，比全局页眉更适合你的需求。

核心思路 #

把每个「标题+条目组」用Section包裹，给Section设置可重复的Header，利用Section提供的IsFirstPage上下文属性，区分显示原标题或带续页标注的标题。

修改后的代码 #

page.Content().Column(column =>
{
    column.Spacing(5);

    for (int i = 0; i < random.Next(1, 10); i++)
    {
        // 用Section包裹当前标题与条目集合，实现跨页重复头部
        column.Item().Section(section =>
        {
            // 定义跨页重复的头部内容
            section.Header().Background(Colors.Red.Accent4).AlignLeft().Padding(2).Text(context =>
            {
                // 根据是否为当前Section的第一页，显示不同标题
                if (context.IsFirstPage)
                    context.Span($" Heading {i}");
                else
                    context.Span($" Heading {i} continued");
            });

            // 原条目内容放入Section的Content区域
            section.Content().Column(contentColumn =>
            {
                contentColumn.Spacing(5);

                for (int j = 0; j < random.Next(1, 20); j++)
                {
                    contentColumn.Item().Row(row =>
                    {
                        row.ConstantItem(100).Text(DateTime.Now.ToShortDateString());
                        row.ConstantItem(100).Text($"{i}. ");
                        row.RelativeItem().ShowEntire().Text($"Some long text that potentially wraps");
                        row.ConstantItem(100).AlignRight().Text("ABC");
                    });
                }
            });
        });
    }
});

为什么之前的全局页眉方案失效？ #

page.Header()是全局文档页眉，作用于所有页面，无法精准关联某个局部内容组的续页状态。而Section的Header是局部作用域，只会在当前Section跨页时自动重复，且能通过上下文判断是否为该Section的第一页，完美匹配你的需求。

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