* @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
* @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
* @link https://github.com/tecnickcom/tc-lib-pdf
*
* This file is part of tc-lib-pdf software library.
*/
// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).
// NOTE: run make fonts in the project root to generate the dependencies and example fonts.
// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';
// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
$pdf = new \Com\Tecnick\Pdf\Tcpdf();
$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 091');
$pdf->setTitle('HTML Inline Alignment');
$pdf->setKeywords('TCPDF tc-lib-pdf example html text-align center right justify rtl inline');
$pdf->setPDFFilename('091_html_inline_alignment.pdf');
$selectFont = function (string $family = 'helvetica', string $style = '', float $size = 10) use ($pdf): void {
$font = $pdf->font->insert($pdf->pon, $family, $style, $size);
$pdf->page->addContent($font['out']);
};
// Reference geometry drawn over the cases.
$guideStyle = [
'lineWidth' => 0.3,
'lineCap' => 'butt',
'lineJoin' => 'miter',
'dashArray' => [1, 1],
'dashPhase' => 0,
'lineColor' => '#cc2244',
];
/**
* Writes a note in absolute page coordinates.
*/
$note = function (string $txt, float $posx, float $posy, float $width, string $style = '', float $size = 8) use (
$pdf,
$selectFont,
): void {
$selectFont('helvetica', $style, $size);
$pdf->page->addContent($pdf->getTextCell(
txt: $txt,
posx: $posx,
posy: $posy,
width: $width,
valign: \Com\Tecnick\Pdf\TextVAlign::Top,
halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));
};
/**
* Adds a page with a title and returns the ordinate of the first case.
*/
$drawTitle = function (string $title, string $expected) use ($pdf, $note): float {
$pdf->addPage();
$note($title, 10, 8, 190, 'B', 12);
$note('Expected: ' . $expected, 10, 15, 190, '', 8);
return 26.0;
};
/**
* Draws a case: a label, the HTML in a 60 mm box at x = 80 mm, the box frame and a
* dashed guide on its center. Returns the ordinate of the next case.
*/
$drawCase = function (string $label, string $html, float $posy, string $family = 'helvetica') use (
$pdf,
$note,
$selectFont,
$guideStyle,
): float {
$note($label, 10, $posy, 65);
$selectFont($family);
$pdf->addHTMLCell($html, 80, $posy, 60);
$height = \max(8.0, $pdf->getLastHTMLCellEnd()['y'] - $posy);
$pdf->page->addContent($pdf->graph->getRect(80, $posy, 60, $height, 'D', ['all' => $guideStyle]));
$pdf->page->addContent($pdf->graph->getLine(110, $posy, 110, $posy + $height, $guideStyle));
return $posy + $height + 6;
};
$lorem = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod';
// ----------
// Part 1: left-to-right lines with inline elements.
// ----------
$posy = $drawTitle(
'Alignment of lines with inline elements',
'centered lines are symmetric about the dashed center guide; right-aligned lines end at the right edge.',
);
$posy = $drawCase(
'center: a line ending before an inline element',
'' . $lorem . '
',
$posy,
);
$posy = $drawCase(
'right: a line ending before an inline element',
'' . $lorem . '
',
$posy,
);
$posy = $drawCase(
'center: table cell with align="center"',
'| Lorem ipsum dolor sit amet, consectetur adipiscing elit |
',
$posy,
);
$posy = $drawCase(
'center: the last line of a wrapped fragment is followed by "do" in bold',
'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed '
. 'do eiusmod tempor
',
$posy,
);
$posy = $drawCase(
'center: italic start, then a wrapped fragment followed by "elit" in bold',
'Lorem ipsum dolor sit amet, consectetur adipiscing '
. 'elit sed do
',
$posy,
);
$posy = $drawCase(
'center: a wrapped fragment followed by a line break, then an inline element',
'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do'
. '
eiusmod tempor
',
$posy,
);
$drawCase(
'justify (reference): every line but the last fills the box',
'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed '
. 'do eiusmod tempor incididunt ut labore et dolore magna aliqua
',
$posy,
);
// ----------
// Part 2: right-to-left runs with inline elements.
// ----------
$posy = $drawTitle(
'Alignment of right-to-left runs with inline elements',
'each line follows text-align as the reference without inline elements; fragments are one space apart.',
);
$hebrew =
"\u{05D0}\u{05D1}\u{05D2}\u{05D3} \u{05D4}\u{05D5}\u{05D6}\u{05D7} \u{05D8}\u{05D9}\u{05DA}\u{05DB} "
. "\u{05DC}\u{05DD}\u{05DE}\u{05DF} \u{05E0}\u{05E1}\u{05E2}\u{05E3}";
$mixed = $hebrew . ' ' . $hebrew . ' ' . $hebrew;
$rtl = '' . $hebrew . ' ' . $hebrew . ' ' . $hebrew . '
',
$posy,
'dejavusans',
);
$posy = $drawCase(
'Hebrew, ' . $align . ', with a bold fragment',
$rtl . $align . '">' . $mixed . '',
$posy,
'dejavusans',
);
}
$drawCase(
'Latin text in a right-to-left block, center',
'' . $lorem . '
',
$posy,
);
// =============================================================
$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);