Skip to content

Formatação de Texto

Demonstra toda a gama de formatação de texto: famílias de fontes, estilos negrito/itálico, tamanhos em pontos, cores RGB, alinhamento via enum Alignment e parágrafos multi-linha.

Exemplo Completo

php
<?php

declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

use TcpdfNext\Document;
use TcpdfNext\Enums\Alignment;

Document::create()
    ->setTitle('Text Formatting')
    ->addPage()

    // -- Font Families ---------------------------------------------------
    ->setFont('helvetica', style: 'B', size: 18)
    ->setTextColor(33, 37, 41)
    ->cell(0, 12, 'Font Families', newLine: true)

    ->setFont('helvetica', size: 12)
    ->cell(0, 8, 'Helvetica -- clean sans-serif', newLine: true)

    ->setFont('times', size: 12)
    ->cell(0, 8, 'Times -- classic serif', newLine: true)

    ->setFont('courier', size: 12)
    ->cell(0, 8, 'Courier -- monospace', newLine: true)

    // -- Styles ----------------------------------------------------------
    ->setFont('helvetica', style: 'B', size: 18)
    ->cell(0, 16, 'Font Styles', newLine: true)

    ->setFont('helvetica', size: 12)
    ->cell(0, 8, 'Regular text', newLine: true)

    ->setFont('helvetica', style: 'B', size: 12)
    ->cell(0, 8, 'Bold text', newLine: true)

    ->setFont('helvetica', style: 'I', size: 12)
    ->cell(0, 8, 'Italic text', newLine: true)

    ->setFont('helvetica', style: 'BI', size: 12)
    ->cell(0, 8, 'Bold + Italic text', newLine: true)

    // -- Sizes -----------------------------------------------------------
    ->setFont('helvetica', style: 'B', size: 18)
    ->cell(0, 16, 'Font Sizes', newLine: true)

    ->setFont('helvetica', size: 8)
    ->cell(0, 6, '8 pt -- fine print', newLine: true)

    ->setFont('helvetica', size: 12)
    ->cell(0, 8, '12 pt -- body text', newLine: true)

    ->setFont('helvetica', size: 20)
    ->cell(0, 12, '20 pt -- subheading', newLine: true)

    ->setFontSize(28)
    ->cell(0, 16, '28 pt -- heading', newLine: true)

    // -- Colors ----------------------------------------------------------
    ->setFont('helvetica', style: 'B', size: 18)
    ->setTextColor(33, 37, 41)
    ->cell(0, 16, 'Text Colors', newLine: true)

    ->setFont('helvetica', size: 12)
    ->setTextColor(220, 53, 69)
    ->cell(0, 8, 'Red (220, 53, 69)', newLine: true)

    ->setTextColor(25, 135, 84)
    ->cell(0, 8, 'Green (25, 135, 84)', newLine: true)

    ->setTextColor(13, 110, 253)
    ->cell(0, 8, 'Blue (13, 110, 253)', newLine: true)

    ->setTextColor(33, 37, 41)

    // -- Alignment -------------------------------------------------------
    ->setFont('helvetica', style: 'B', size: 18)
    ->cell(0, 16, 'Text Alignment', newLine: true)

    ->setFont('helvetica', size: 12)
    ->cell(0, 8, 'Left-aligned (default)', align: Alignment::Left, newLine: true)
    ->cell(0, 8, 'Center-aligned',         align: Alignment::Center, newLine: true)
    ->cell(0, 8, 'Right-aligned',          align: Alignment::Right, newLine: true)

    // -- Multi-Line Paragraph --------------------------------------------
    ->setFont('helvetica', style: 'B', size: 18)
    ->cell(0, 16, 'Multi-Line Text', newLine: true)

    ->setFont('helvetica', size: 11)
    ->multiCell(
        width:  0,
        height: 7,
        text:   "TCPDF-Next wraps text automatically with multiCell().\n"
              . "Use the Alignment enum for justified, left, center, or right alignment.\n"
              . "Line spacing is controlled by the height parameter.",
        align:  Alignment::Justified,
    )

    ->save(__DIR__ . '/text-formatting.pdf');

echo 'PDF created.' . PHP_EOL;

Conceitos-Chave

Caracteres de Estilo

CaractereSignificado
(vazio)Regular
BNegrito
IItálico
BINegrito + Itálico

setTextColor(r, g, b)

Aceita inteiros RGB de 0 a 255. Chame antes de qualquer método de escrita de texto:

php
->setTextColor(13, 110, 253)   // blue

Enum Alignment

ValorEfeito
Alignment::LeftAlinhado à esquerda (padrão)
Alignment::CenterCentralizado
Alignment::RightAlinhado à direita
Alignment::JustifiedJustificado (apenas multiCell)

cell() vs multiCell()

  • cell() -- linha única, sem quebra de texto.
  • multiCell() -- quebra texto dentro da largura especificada e suporta justificação.

Saída

O PDF gerado contém uma página exibindo três famílias de fontes, quatro variantes de estilo, quatro tamanhos, três cores, três modos de alinhamento e um parágrafo justificado.

Distribuído sob a licença LGPL-3.0-or-later.