書籤（文件大綱）¶

use NextPDF\Navigation\BookmarkManager;
use NextPDF\Navigation\Bookmark;

$bookmarks = $document->bookmarks();

// 頂層書籤（指向頁碼）
$ch1 = $bookmarks->add(
    title: 'Chapter 1: Introduction',
    destination: Destination::page(pageNumber: 1),
);

$ch2 = $bookmarks->add(
    title: 'Chapter 2: Architecture',
    destination: Destination::page(pageNumber: 5),
);

// 巢狀子書籤
$ch2->addChild(
    title: '2.1 System Overview',
    destination: Destination::page(pageNumber: 5),
);

$ch2->addChild(
    title: '2.2 Component Design',
    destination: Destination::page(pageNumber: 8),
);

use NextPDF\Navigation\Destination;

// 跳至指定頁面（頂部）
Destination::page(pageNumber: 3);

// 跳至頁面的特定 XYZ 座標（縮放至 150%）
Destination::xyz(
    pageNumber: 3,
    x: 20.0,
    y: 250.0,
    zoom: 1.5,
);

// 適合頁面寬度
Destination::fitWidth(pageNumber: 3, y: 200.0);

// 適合頁面
Destination::fit(pageNumber: 3);

// 具名目標（Named Destination）
Destination::named(name: 'section-2-1');

// 粗體、斜體書籤（用於強調重要章節）
$bookmarks->add(
    title: 'Appendix A',
    destination: Destination::page(pageNumber: 45),
    bold: true,
    italic: false,
    color: Color::rgb(r: 30, g: 58, b: 138),
);

// 預設展開（顯示子書籤）
$ch1->setExpanded(true);

// 預設折疊（子書籤隱藏）
$ch2->setExpanded(false);

// 與 TocBuilder 聯動，從目錄條目自動生成書籤
$toc = $document->toc();
$toc->autoGenerateBookmarks(true);