Skip to content

Форматирование текста

Демонстрация полного спектра форматирования текста: семейства шрифтов, жирный/курсивный стили, размеры в пунктах, RGB-цвета, выравнивание через enum Alignment и многострочные абзацы.

Полный пример

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;

Ключевые концепции

Символы стилей

СимволЗначение
(пусто)Обычный
BЖирный
IКурсив
BIЖирный + Курсив

setTextColor(r, g, b)

Принимает целые числа RGB 0--255. Вызывайте перед любым методом записи текста:

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

Enum Alignment

ЗначениеЭффект
Alignment::LeftПо левому краю (по умолчанию)
Alignment::CenterПо центру
Alignment::RightПо правому краю
Alignment::JustifiedПо ширине (только multiCell)

cell() vs multiCell()

  • cell() -- однострочный, без переноса.
  • multiCell() -- переносит текст в заданной ширине и поддерживает выравнивание по ширине.

Результат

Сгенерированный PDF содержит одну страницу, демонстрирующую три семейства шрифтов, четыре варианта стилей, четыре размера, три цвета, три режима выравнивания и абзац, выровненный по ширине.

Распространяется по лицензии LGPL-3.0-or-later.