PDF/UA 無障礙合規¶

use NextPDF\Core\Configuration;
use NextPDF\Core\Conformance;

$config = Configuration::create(
    conformance: Conformance::PDF_UA_2,  // 啟用 PDF/UA-2 合規模式
    taggedPdf: true,                      // 自動啟用（Conformance 包含此項）
    title: 'Accessible Annual Report',   // 必要：非空標題
    documentLanguage: 'zh-TW',           // 必要：文件語言
);

// PDF/UA-2 模式下，以下操作會在 finalize() 前自動驗證：
// 1. 所有非裝飾性圖形必須有 Alt 文字
// 2. 表格必須有 TH 標頭（含 Scope 屬性）
// 3. 清單必須使用正確的 L/LI/Lbl/LBody 結構
// 4. 標題序列（H1→H2→H3）不可跳層
// 5. 所有連結必須有可理解的文字

use NextPDF\Accessibility\PdfUaValidator;
use NextPDF\Accessibility\ValidationReport;

$validator = PdfUaValidator::create();

$report = $validator->validate(
    pdf: $document->finalize(),
    level: PdfUaLevel::UA2,
);

// 顯示驗證結果
echo "Valid: " . ($report->isValid() ? 'Yes' : 'No') . PHP_EOL;

foreach ($report->getErrors() as $error) {
    echo "[ERROR] Rule {$error->getRuleId()}: {$error->getMessage()}" . PHP_EOL;
    echo "        Location: {$error->getLocation()}" . PHP_EOL;
}

foreach ($report->getWarnings() as $warning) {
    echo "[WARN] {$warning->getMessage()}" . PHP_EOL;
}

use NextPDF\Accessibility\StructureType;
use NextPDF\Accessibility\TableScope;

// 建立無障礙表格結構
$table = $structTree->root()->addChild(StructureType::Table);
$table->setAttribute('Summary', 'Financial results for FY2026');

$headerRow = $table->addChild(StructureType::TR);

$th1 = $headerRow->addChild(StructureType::TH);
$th1->setAttribute('Scope', TableScope::Column);  // Column | Row | Both
$th1->setAlternateText('Product Name');

$td1 = $headerRow->addChild(StructureType::TD);
$td1->setAttribute('Headers', 'th-product-name');  // 關聯標頭

// 文件中局部語言切換
$spanElem = $section->addChild(StructureType::Span);
$spanElem->setAttribute('Lang', 'en');  // 局部語言覆蓋

$document->text()->write(
    text: 'The term "PDF/UA" stands for Universal Accessibility.',
    position: Position::at(x: 20.0, y: 100.0),
    structureElement: $spanElem,
);