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-1 — Auto-Tagged HTML Showcase
'
    . '
Mode: pdfua1 (ISO 14289-1, PDF 1.7). This document'
    . ' demonstrates every HTML element that addHTMLCell() auto-tags with a'
    . ' PDF/UA-1 structure role. PDF/UA-1 is the original accessible-PDF standard: it mandates'
    . ' a tagged structure tree, document language, MarkInfo /Marked true,'
    . ' and ViewerPreferences /DisplayDocTitle true. All of these are written'
    . ' automatically when the pdfua1 mode is active.
'
    . '
1 — Heading and Paragraph Roles
'
    . '
H3 Sub-heading
'
    . '
The h1-h6 tags map to PDF roles H1-H6.'
    . ' The p tag maps to P.'
    . ' PDF/UA-1 requires that heading levels are not skipped: the library clamps each'
    . ' heading to at most one level deeper than the previous heading to maintain a'
    . ' well-formed outline that screen readers can navigate.
'
    . '
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-1 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-1 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. PDF/UA-1 requires that link annotations have an accessible name,'
    . ' which the library derives from the link text in the structure tree.
'
    . '
7 — Rules, Spans and Empty Cells
'
    . '
A horizontal rule carries no semantics, so it is emitted as an Artifact'
    . ' rather than left as untagged content (PDF/UA-1 7.1):
'
    . '
'
    . '
Cell colspan/rowspan are recorded on the cell structure'
    . ' element as integer /ColSpan and /RowSpan attributes,'
    . ' and an empty cell is kept in the tree so the row keeps its full column count (7.2):
'
    . ''
    . ''
    . ''
    . ''
    . ''
    . '
Col A
Col B
Col C
Spans columns A and B
C
Spans rows
B2
C2
B3
';

// A long table that breaks across pages: the repeated header on each continuation
// page is an Artifact, while the single Table structure element keeps all its rows.
$html .=
    '
8 — Page-Spanning Table
'
    . ''
    . '';
for ($row = 1; $row <= 60; ++$row) {
    $html .= '';
}

$html .= '
#
Description
' . $row . '
Continuation row ' . $row . '
';

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

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