Trợ năng (PDF/UA)

★ Pro — Commercial License Required

Tính năng trợ năng PDF/UA yêu cầu package Pro.

TCPDF-Next Pro cung cấp hỗ trợ PDF/UA (ISO 14289-2) đầy đủ để tạo PDF document trợ năng hoạt động với trình đọc màn hình và công nghệ trợ năng.

Bật Tagged PDF

use Yeeefang\TcpdfNext\Core\Document;

$pdf = Document::create()
    ->setTaggedPdf(true)
    ->setLanguage('en-US');

Structure Tree

StructureTreeManager tự động xây dựng structure tree document khi bạn dùng tag cấu trúc:

$pdf->openTag('H1')
    ->cell(0, 10, 'Annual Report 2026', newLine: true)
    ->closeTag('H1')

    ->openTag('P')
    ->multiCell(0, 6, 'This report provides an overview...')
    ->closeTag('P');

Structure Element được hỗ trợ

Phần tử	Mục đích
Document	Structure element gốc
Part, Sect	Phần document
H1 -- H6	Tiêu đề
P	Đoạn văn
Table, TR, TH, TD	Cấu trúc bảng
L, LI	Cấu trúc danh sách
Figure	Hình ảnh và sơ đồ
Link	Hyperlink
Span	Nội dung inline

Role Mapping

Ánh xạ tên tag tùy chỉnh sang kiểu structure PDF chuẩn:

$pdf->setRoleMap([
    'invoice-header' => 'H1',
    'line-item' => 'TR',
    'summary' => 'P',
]);

Alt Text cho hình ảnh

$pdf->image('/path/to/chart.png', 10, 10, 100, 80, alt: 'Revenue chart showing Q1-Q4 growth');

Kết hợp PDF/A-4 + PDF/UA

Để tuân thủ tối đa, kết hợp lưu trữ và trợ năng:

$pdf = Document::create()
    ->enablePdfA(PdfAVersion::A4)
    ->setTaggedPdf(true)
    ->setLanguage('en-US');