Elementos

Texto

El elemento mas fundamental. Agregue texto con estilo opcional:

c.Text("Hello, World!")
c.Text("Styled text", template.FontSize(18), template.Bold())
c.Text("Red centered", template.TextColor(pdf.Red), template.AlignCenter())

Opciones de texto

Opcion	Descripcion
`FontSize(size)`	Tamano de fuente en puntos (predeterminado: 12)
`Bold()`	Peso negrita
`Italic()`	Estilo cursiva
`FontFamily(name)`	Usar una fuente registrada
`TextColor(color)`	Color de primer plano
`BgColor(color)`	Color de fondo
`AlignLeft()`	Alineacion izquierda (predeterminado)
`AlignCenter()`	Alineacion centrada
`AlignRight()`	Alineacion derecha
`Underline()`	Decoracion de subrayado
`Strikethrough()`	Decoracion de tachado
`LetterSpacing(pts)`	Espacio adicional entre caracteres
`TextIndent(value)`	Sangria de primera linea

Texto enriquecido

Texto en linea de estilo mixto usando RichText():

c.RichText(func(rt *template.RichTextBuilder) {
    rt.Span("Normal text ")
    rt.Span("bold", template.Bold())
    rt.Span(" and ")
    rt.Span("red", template.TextColor(pdf.Red))
    rt.Span(" in one line.")
})

┌─────────────────────────────────────────────┐
│  Normal text bold and red in one line.      │
│              ^^^^     ^^^                   │
│              bold     red color             │
└─────────────────────────────────────────────┘

Tabla

Tablas con encabezados y filas de datos:

// Basic table
c.Table(
    []string{"Name", "Age", "City"},
    [][]string{
        {"Alice", "30", "Tokyo"},
        {"Bob", "25", "New York"},
        {"Charlie", "35", "London"},
    },
)

┌──────────┬──────┬──────────┐
│  Name    │ Age  │  City    │ ← encabezado (negrita)
├──────────┼──────┼──────────┤
│  Alice   │  30  │  Tokyo   │
│  Bob     │  25  │  New York│
│  Charlie │  35  │  London  │
└──────────┴──────┴──────────┘

Tabla con estilo

darkBlue := pdf.RGBHex(0x1A237E)
lightGray := pdf.RGBHex(0xF5F5F5)

c.Table(
    []string{"Product", "Category", "Qty", "Unit Price", "Total"},
    [][]string{
        {"Laptop Pro 15", "Electronics", "2", "$1,299.00", "$2,598.00"},
        {"Wireless Mouse", "Accessories", "10", "$29.99", "$299.90"},
        {"USB-C Hub", "Accessories", "5", "$49.99", "$249.95"},
        {"Monitor 27\"", "Electronics", "3", "$399.00", "$1,197.00"},
        {"Keyboard", "Accessories", "10", "$79.99", "$799.90"},
        {"Webcam HD", "Electronics", "4", "$89.99", "$359.96"},
    },
    template.ColumnWidths(30, 20, 10, 20, 20),
    template.TableHeaderStyle(
        template.TextColor(pdf.White),
        template.BgColor(darkBlue),
    ),
    template.TableStripe(lightGray),
)

┌─────────────┬────────────┬─────┬───────────┬──────────┐
│  Product    │  Category  │ Qty │Unit Price │  Total   │ ← blanco sobre azul oscuro
├─────────────┼────────────┼─────┼───────────┼──────────┤
│  Laptop Pro │ Electronics│  2  │ $1,299.00 │$2,598.00 │ ← fondo blanco
│  Wireless.. │ Accessories│ 10  │    $29.99 │  $299.90 │ ← franja gris
│  USB-C Hub  │ Accessories│  5  │    $49.99 │  $249.95 │ ← fondo blanco
│  Monitor 27"│ Electronics│  3  │   $399.00 │$1,197.00 │ ← franja gris
│  Keyboard   │ Accessories│ 10  │    $79.99 │  $799.90 │ ← fondo blanco
│  Webcam HD  │ Electronics│  4  │    $89.99 │  $359.96 │ ← franja gris
└─────────────┴────────────┴─────┴───────────┴──────────┘

Opciones de tabla

Opcion	Descripcion
`ColumnWidths(widths...)`	Porcentajes de ancho de columna (deben sumar 100)
`TableHeaderStyle(opts...)`	Estilo para la fila de encabezado
`TableStripe(color)`	Color de fondo alternado de filas
`TableCellVAlign(align)`	Alineacion vertical: `VAlignTop`, `VAlignMiddle`, `VAlignBottom`

Alineacion vertical de tabla

c.Table(
    []string{"Align", "Short", "Long Content"},
    [][]string{
        {"Top", "A", "This is a longer text that wraps to multiple lines"},
        {"Middle", "B", "Another longer text for demonstration purposes"},
    },
    template.TableCellVAlign(document.VAlignMiddle),
)

Imagen

Agregue imagenes JPEG o PNG:

imgData, _ := os.ReadFile("photo.jpg")

c.Image(imgData)
c.Image(imgData, template.FitWidth(document.Mm(80)))
c.Image(imgData, template.FitHeight(document.Mm(50)))

Opciones de imagen

Opcion	Descripcion
`FitWidth(value)`	Escalar al ancho especificado
`FitHeight(value)`	Escalar a la altura especificada
`WithFitMode(mode)`	Modo de ajuste: `FitContain`, `FitCover`, `FitStretch`, `FitOriginal`
`WithAlign(align)`	Alineacion horizontal: `AlignLeft`, `AlignCenter`, `AlignRight`

Modos de ajuste de imagen

// Contain: scale to fit, preserve aspect ratio (default)
c.Image(data, template.WithFitMode(document.FitContain))

// Cover: scale to fill, may crop
c.Image(data, template.WithFitMode(document.FitCover))

// Stretch: fill bounds, may distort
c.Image(data, template.WithFitMode(document.FitStretch))

// Original: use original dimensions
c.Image(data, template.WithFitMode(document.FitOriginal))

Alineacion de imagen

c.Image(data, template.FitWidth(document.Mm(40)), template.WithAlign(document.AlignCenter))
c.Image(data, template.FitWidth(document.Mm(40)), template.WithAlign(document.AlignRight))

Lista

Lista desordenada

c.List([]string{
    "Declarative document definition",
    "All element types supported",
    "Style options (bold, italic, color, align)",
    "Header and footer support",
})

┌─────────────────────────────────────────────┐
│  • Declarative document definition          │
│  • All element types supported              │
│  • Style options (bold, italic, color, ...)  │
│  • Header and footer support                │
└─────────────────────────────────────────────┘

Lista ordenada

c.OrderedList([]string{
    "Text with styles",
    "Tables with headers",
    "Lists (ordered/unordered)",
    "Lines and spacers",
    "QR codes and barcodes",
})

┌─────────────────────────────────────────────┐
│  1. Text with styles                        │
│  2. Tables with headers                     │
│  3. Lists (ordered/unordered)               │
│  4. Lines and spacers                       │
│  5. QR codes and barcodes                   │
└─────────────────────────────────────────────┘

Opciones de lista

Opcion	Descripcion
`ListIndent(value)`	Sangria desde la izquierda

Linea

Lineas horizontales con color y grosor opcionales:

// Default line (gray, 1pt)
c.Line()

// Colored line
c.Line(template.LineColor(pdf.Red))
c.Line(template.LineColor(pdf.Blue))

// Custom thickness
c.Line(template.LineThickness(document.Pt(0.5)))   // thin
c.Line(template.LineThickness(document.Pt(2)))     // medium
c.Line(template.LineThickness(document.Pt(5)))     // thick

// Color + thickness
c.Line(
    template.LineColor(pdf.RGBHex(0x1A237E)),
    template.LineThickness(document.Pt(2)),
)

┌─────────────────────────────────────────────┐
│  Default line:                              │
│  ─────────────────────────────── (gray 1pt) │
│  Red line:                                  │
│  ─────────────────────────────── (red)      │
│  Thin (0.5pt):                              │
│  ─────────────────────────────── (thin)     │
│  Thick (5pt):                               │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ (thick)    │
└─────────────────────────────────────────────┘

Opciones de linea

Opcion	Descripcion
`LineColor(color)`	Color de la linea
`LineThickness(value)`	Grosor de la linea

Espaciador

Agregue espacio vertical entre elementos:

c.Text("Before spacer")
c.Spacer(document.Mm(10))    // 10mm gap
c.Text("After spacer")

c.Spacer(document.Mm(5))     // 5mm
c.Spacer(document.Mm(15))    // 15mm
c.Spacer(document.Mm(30))    // 30mm

┌─────────────────────────────────────────────┐
│  Before spacer                              │
│                                             │
│                  ↕ 10mm                     │
│                                             │
│  After spacer                               │
└─────────────────────────────────────────────┘

Codigo QR

Genere codigos QR a partir de texto o URLs:

// Basic QR code
c.QRCode("https://gpdf.dev")

// With custom size
c.QRCode("https://gpdf.dev", template.QRSize(document.Mm(30)))

// With error correction level
c.QRCode("HELLO", template.QRSize(document.Mm(25)),
    template.QRErrorCorrection(qrcode.LevelH))

// Japanese content
c.QRCode("こんにちは世界", template.QRSize(document.Mm(30)))

Codigos QR con diferentes tamanos

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(4, func(c *template.ColBuilder) {
        c.Text("20mm", template.FontSize(9))
        c.QRCode("https://gpdf.dev", template.QRSize(document.Mm(20)))
    })
    r.Col(4, func(c *template.ColBuilder) {
        c.Text("30mm", template.FontSize(9))
        c.QRCode("https://gpdf.dev", template.QRSize(document.Mm(30)))
    })
    r.Col(4, func(c *template.ColBuilder) {
        c.Text("40mm", template.FontSize(9))
        c.QRCode("https://gpdf.dev", template.QRSize(document.Mm(40)))
    })
})

┌───────────────┬───────────────┬───────────────┐
│  20mm         │  30mm         │  40mm         │
│  ┌──┐         │  ┌────┐       │  ┌──────┐     │
│  │QR│         │  │ QR │       │  │  QR  │     │
│  └──┘         │  └────┘       │  │      │     │
│               │               │  └──────┘     │
└───────────────┴───────────────┴───────────────┘

Niveles de correccion de errores

Nivel	Recuperacion	Ideal para
`qrcode.LevelL`	~7%	Entornos limpios
`qrcode.LevelM`	~15%	Uso general (predeterminado)
`qrcode.LevelQ`	~25%	Uso industrial
`qrcode.LevelH`	~30%	Entornos adversos

import "github.com/gpdf-dev/gpdf/qrcode"

c.QRCode("HELLO", template.QRErrorCorrection(qrcode.LevelH))

Opciones de codigo QR

Opcion	Descripcion
`QRSize(value)`	Tamano de visualizacion (ancho = alto)
`QRErrorCorrection(level)`	Nivel de correccion de errores
`QRScale(s)`	Pixeles por modulo QR

Codigo de barras

Genere codigos de barras Code 128:

// Basic barcode
c.Barcode("INV-2026-0001")

// With custom width
c.Barcode("PRODUCT-A-12345", template.BarcodeWidth(document.Mm(80)))

// With custom height
c.Barcode("SMALL-BAR", template.BarcodeHeight(document.Mm(10)))

// Numeric data (automatically optimized with Code C)
c.Barcode("1234567890")

Codigos de barras en columnas

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("Item A", template.FontSize(9))
        c.Barcode("ITEM-A-001", template.BarcodeWidth(document.Mm(60)))
    })
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("Item B", template.FontSize(9))
        c.Barcode("ITEM-B-002", template.BarcodeWidth(document.Mm(60)))
    })
})

┌────────────────────────┬────────────────────────┐
│  Item A                │  Item B                │
│  ║║│║║│║║║│║║│║║│      │  ║║│║║│║║║│║║│║║│      │
│  ITEM-A-001            │  ITEM-B-002            │
└────────────────────────┴────────────────────────┘

Opciones de codigo de barras

Opcion	Descripcion
`BarcodeWidth(value)`	Ancho de visualizacion
`BarcodeHeight(value)`	Alto de visualizacion
`BarcodeFormat(format)`	Formato del codigo de barras (predeterminado: Code 128)

Posicionamiento absoluto

Coloque elementos en coordenadas XY exactas en la pagina, fuera del flujo normal de la cuadricula. Util para marcas de agua, sellos, logotipos y superposiciones.

page.Absolute(document.Mm(120), document.Mm(20), func(c *template.ColBuilder) {
    c.Text("CONFIDENTIAL", template.FontSize(20), template.Bold(), template.TextColor(pdf.Red))
})

// With explicit size
page.Absolute(document.Mm(10), document.Mm(250), func(c *template.ColBuilder) {
    c.QRCode("https://gpdf.dev", template.QRSize(document.Mm(20)))
}, gpdf.AbsoluteWidth(document.Mm(25)), gpdf.AbsoluteHeight(document.Mm(25)))

// Use page corner as origin (ignores margins)
page.Absolute(document.Mm(0), document.Mm(0), func(c *template.ColBuilder) {
    c.Text("Top-left corner of page")
}, gpdf.AbsoluteOriginPage())

┌─ Page ──────────────────────────────────────────┐
│  ┌─ Content Area ───────────────────────────┐   │
│  │                                          │   │
│  │   [Normal flow content]                  │   │
│  │                                          │   │
│  │              ┌──────────────┐            │   │
│  │              │ CONFIDENTIAL │ ← absolute │   │
│  │              └──────────────┘   (120,20) │   │
│  │                                          │   │
│  │   ┌──┐                                   │   │
│  │   │QR│ ← absolute (10,250)               │   │
│  │   └──┘                                   │   │
│  └──────────────────────────────────────────┘   │
└─────────────────────────────────────────────────┘

Origenes de coordenadas

Origen	Descripcion	Predeterminado
Area de contenido	XY relativo a la esquina superior izquierda del area de contenido (dentro de margenes)	Si
Pagina	XY relativo a la esquina superior izquierda de la pagina (ignora margenes)	No

Opciones de posicionamiento absoluto

Opcion	Descripcion
`AbsoluteWidth(value)`	Ancho explicito para el bloque absoluto
`AbsoluteHeight(value)`	Alto explicito para el bloque absoluto
`AbsoluteOriginPage()`	Usar esquina de pagina como origen en lugar del area de contenido

Numero de pagina / Total de paginas

Numeracion automatica de paginas en encabezados o pies de pagina:

// Current page number (e.g., "1", "2", "3")
c.PageNumber(template.AlignRight(), template.FontSize(8))

// Total page count (e.g., "4 total pages")
c.TotalPages(template.AlignRight(), template.FontSize(9))

Ambos aceptan opciones de texto estandar para el estilo.