使用borb调整页边距后，Table及HorizontalRule无法占满页面的解决方法

问题描述 #

使用borb缩小PDF页面边距后，边距修改生效，但Table出现偏移且无法占满页面宽度，HorizontalRule等元素也存在相同问题。

问题代码示例 #

from decimal import Decimal

from borb.pdf import Document, Page, SingleColumnLayout, PageLayout, Paragraph, Image, PDF


def main():

    # Create document
    pdf = Document()

    # Add page
    page = Page()
    pdf.add_page(page)

    # create PageLayout
    page_layout: PageLayout = SingleColumnLayout(page)

    for i in [Decimal(0), Decimal(16), Decimal(32), Decimal(64)]:

        page_layout._margin_left = i
        page_layout._margin_right = i
        page_layout._margin_bottom = i
        page_layout._margin_top = i

        # Add Paragraph
        page_layout.add(Paragraph(f"padding set at {int(i)}"))
        page_layout.add(
            FixedColumnWidthTable(
                number_of_columns=3, number_of_rows=3
            )
        )

    with open("output.pdf", "wb") as out_file_handle:
        PDF.dumps(out_file_handle, pdf)

if __name__ == "__main__":
    main()

解决方案 #

核心问题是直接修改_margin_left这类私有属性，未触发布局的宽度重新计算。正确做法是使用布局类的公开方法设置边距，并明确指定Table等元素的宽度适配逻辑。

修改后代码示例 #

from decimal import Decimal

from borb.pdf import Document, Page, SingleColumnLayout, Paragraph, FixedColumnWidthTable, PDF, HorizontalRule, RelativeWidth


def main():
    # 创建文档
    pdf = Document()

    # 添加页面
    page = Page()
    pdf.add_page(page)

    # 创建PageLayout
    page_layout = SingleColumnLayout(page)

    for i in [Decimal(0), Decimal(16), Decimal(32), Decimal(64)]:
        # 使用公开方法设置边距，自动触发布局宽度重计算
        page_layout.set_margins(
            top=i,
            right=i,
            bottom=i,
            left=i
        )

        # 添加段落
        page_layout.add(Paragraph(f"边距设置为 {int(i)}"))
        
        # 创建表格并设置占满可用宽度
        table = FixedColumnWidthTable(number_of_columns=3, number_of_rows=3)
        # 添加表格内容（可选，用于直观验证效果）
        for row in range(3):
            for col in range(3):
                table.add(Paragraph(f"单元格 {row+1}-{col+1}"))
        # 设置表格宽度为布局可用宽度的100%
        table.set_width(Decimal(100), RelativeWidth())
        page_layout.add(table)

        # 添加HorizontalRule验证修复效果
        page_layout.add(HorizontalRule())

    with open("output.pdf", "wb") as out_file_handle:
        PDF.dumps(out_file_handle, pdf)

if __name__ == "__main__":
    main()

关键修复点 #

1. 使用公开方法设置边距：调用set_margins而非直接修改私有属性，该方法会自动更新布局的内部状态，重新计算可用宽度。
2. 指定Table宽度适配：通过set_width(Decimal(100), RelativeWidth())让表格占满布局的可用宽度，适配修改后的边距。

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