gpdf

ヘッダーとフッター

ヘッダー

doc.Header() を使って、すべてのページに繰り返し表示されるヘッダーを定義します:

doc := template.New(
    template.WithPageSize(document.A4),
    template.WithMargins(document.UniformEdges(document.Mm(20))),
)

doc.Header(func(p *template.PageBuilder) {
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(6, func(c *template.ColBuilder) {
            c.Text("ACME Corporation", template.Bold(), template.FontSize(10))
        })
        r.Col(6, func(c *template.ColBuilder) {
            c.Text("Confidential Report", template.AlignRight(), template.FontSize(10),
                template.TextColor(pdf.Gray(0.5)))
        })
    })
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Line(template.LineColor(pdf.RGBHex(0x1565C0)), template.LineThickness(document.Pt(2)))
            c.Spacer(document.Mm(5))
        })
    })
})

フッター

doc.Footer() を使って、すべてのページに繰り返し表示されるフッターを定義します:

doc.Footer(func(p *template.PageBuilder) {
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Spacer(document.Mm(5))
            c.Line(template.LineColor(pdf.Gray(0.7)))
            c.Spacer(document.Mm(2))
        })
    })
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(6, func(c *template.ColBuilder) {
            c.Text("Generated by gpdf", template.FontSize(8),
                template.TextColor(pdf.Gray(0.5)))
        })
        r.Col(6, func(c *template.ColBuilder) {
            c.Text("Confidential", template.FontSize(8),
                template.AlignRight(), template.TextColor(pdf.Gray(0.5)))
        })
    })
})

完全な例

// Three pages of content — header and footer repeat on each page
for range 3 {
    page := doc.AddPage()
    page.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Text("Main Content Area", template.FontSize(16), template.Bold())
            c.Spacer(document.Mm(5))
            c.Text("The header and footer repeat on every page automatically.")
        })
    })
}

┌─ Page 1 ──────────────────────────────────────┐
│  ACME Corporation        Confidential Report  │  ← ヘッダー
│  ─────────────────────────────────────────── │
│                                               │
│  Main Content Area                            │
│  The header and footer repeat on every page.  │
│                                               │
│  ─────────────────────────────────────────── │
│  Generated by gpdf                Confidential│  ← フッター
└───────────────────────────────────────────────┘

┌─ Page 2 ──────────────────────────────────────┐
│  ACME Corporation        Confidential Report  │  ← 同じヘッダー
│  ─────────────────────────────────────────── │
│                                               │
│  Main Content Area                            │
│  The header and footer repeat on every page.  │
│                                               │
│  ─────────────────────────────────────────── │
│  Generated by gpdf                Confidential│  ← 同じフッター
└───────────────────────────────────────────────┘

ページ番号

PageNumber() と TotalPages() を使って自動ページ番号を付けます:

// Header with total pages
doc.Header(func(p *template.PageBuilder) {
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(6, func(c *template.ColBuilder) {
            c.Text("Page Number Demo", template.Bold(), template.FontSize(10))
        })
        r.Col(6, func(c *template.ColBuilder) {
            c.TotalPages(template.AlignRight(), template.FontSize(9),
                template.TextColor(pdf.Gray(0.5)))
        })
    })
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Line(template.LineColor(pdf.RGBHex(0x1565C0)))
            c.Spacer(document.Mm(3))
        })
    })
})

// Footer with page number
doc.Footer(func(p *template.PageBuilder) {
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Spacer(document.Mm(3))
            c.Line(template.LineColor(pdf.Gray(0.7)))
            c.Spacer(document.Mm(2))
        })
    })
    p.AutoRow(func(r *template.RowBuilder) {
        r.Col(6, func(c *template.ColBuilder) {
            c.Text("Generated by gpdf", template.FontSize(8),
                template.TextColor(pdf.Gray(0.5)))
        })
        r.Col(6, func(c *template.ColBuilder) {
            c.PageNumber(template.AlignRight(), template.FontSize(8),
                template.TextColor(pdf.Gray(0.5)))
        })
    })
})

// Create 4 pages
for i := range 4 {
    page := doc.AddPage()
    titles := []string{"Introduction", "Background", "Analysis", "Conclusion"}
    page.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Text(titles[i], template.FontSize(18), template.Bold())
        })
    })
}

┌─ Page 1 ──────────────────────────────────────┐
│  Page Number Demo               4 total pages │  ← TotalPages()
│  ──────────────────────────────────────────── │
│                                               │
│  Introduction                                 │
│                                               │
│  ──────────────────────────────────────────── │
│  Generated by gpdf                      Page 1│  ← PageNumber()
└───────────────────────────────────────────────┘

┌─ Page 4 ──────────────────────────────────────┐
│  Page Number Demo               4 total pages │
│  ──────────────────────────────────────────── │
│                                               │
│  Conclusion                                   │
│                                               │
│  ──────────────────────────────────────────── │
│  Generated by gpdf                      Page 4│
└───────────────────────────────────────────────┘

複数ページドキュメント

コンテンツがページを超えると、gpdfは自動的に新しいページを作成します。ヘッダーとフッター（ページ番号を含む）は各ページに適用されます。

// Create explicit pages
for i := range 5 {
    page := doc.AddPage()
    page.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Text(fmt.Sprintf("Page %d content", i+1))
        })
    })
}

次のステップ