default to the
// non-embedded standard-14 Courier, so register an embedded monospace font and
// select it for those elements.
$pdf->font->insert($pdf->pon, 'dejavusansmono', '', 10);
$pdf->setHTMLMonospaceFont('dejavusansmono');

$pdf->addPage();
$pdf->page->addContent($font['out']);

$imgPath = __DIR__ . '/images/tcpdf_logo.jpg';

$html =
    '
PDF/UA-2 — Auto-Tagged HTML Showcase
'
    . '
Mode: pdfua2 (ISO 14289-2, PDF 2.0). This document'
    . ' demonstrates every HTML element that addHTMLCell() auto-tags with a'
    . ' PDF/UA-2 structure role. PDF/UA-2 advances the accessible-PDF standard onto the'
    . ' PDF 2.0 generation: it uses the updated PDF/UA-2 XMP identification schema'
    . ' and targets PDF version 2.0 while applying the same structure-tree, MarkInfo,'
    . ' /Lang, and heading-clamping rules as PDF/UA-1. The document infrastructure'
    . ' difference is transparent to the HTML tagging layer — all roles map identically.
'
    . '
1 — Heading and Paragraph Roles
'
    . '
H3 Sub-heading
'
    . '
The h1-h6 tags map to PDF roles H1-H6.'
    . ' The p tag maps to P.'
    . ' Heading levels are clamped to prevent skipped levels: if an h3'
    . ' follows an h1 without an intervening h2, the library'
    . ' silently promotes it to H2 so the PDF/UA heading-nesting rule is not violated.
'
    . '
2 — Block Roles
'
    . '
“Tagged PDF is the foundation of accessible PDF. Without a'
    . ' well-formed structure tree, automated tools and assistive technologies cannot'
    . ' reliably interpret document content.” — ISO 14289 rationale
'
    . '
The blockquote tag maps to BlockQuote.
'
    . '
3 — List Structure (L > LI > Lbl + LBody)
'
    . '
Both ul and ol map to the L role.'
    . ' Each li auto-generates LI > {Lbl, LBody} children:
'
    . '
'
    . '
Unordered item — ul/li tags produce L/LI structure
'
    . '
The bullet character is placed in a Lbl child element
'
    . '
Body text is wrapped in a LBody child element
'
    . '
'
    . '
'
    . '
Ordered item — the number is auto-generated as the Lbl
'
    . '
Body text is again auto-wrapped in LBody
'
    . '
Nesting: L > LI > {Lbl, LBody}
'
    . '
'
    . '
4 — Figure, Image Alt-Text, and Caption
'
    . '
'
    . ''
    . ''
    . '
'
    . '
5 — Table Structure (Table > TR > TH/TD)
'
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . ''
    . '
Table 1 — HTML tags and their PDF/UA-2 structure roles
HTML tag
PDF structure role
Category
h1–h6
H1–H6
Heading
p
P
Body
blockquote
BlockQuote
Body
pre
Code
Body
ul, ol
L
List
li
LI + Lbl + LBody
List
figure
Figure
Illustration
img (with alt)
Figure + /Alt
Illustration
figcaption, caption
Caption
Illustration
table
Table
Table
tr
TR
Table
td
TD
Table
th
TH
Table
a
Link
Inline
'
    . '
6 — Hyperlink (Link Role)
'
    . '
This sentence contains a'
    . ' hyperlink to the tc-lib-pdf repository;'
    . ' the a element is tagged with the Link structure role'
    . ' automatically. In PDF/UA-2 (as in PDF/UA-1), link annotations must be accessible;'
    . ' the library derives the accessible name from the link text in the structure tree.
';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);