Fragment

Fragmentは、PDF仕様書 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) において、PDF文書内の特定の位置やビューを識別するためのオプションコンポーネントです。HTMLのアンカーに似た機能を持ち、通常はURIまたはデスティネーション（宛先）仕様の一部として表現され、特定のコンテンツへのナビゲーションを可能にします。この識別子により、PDFファイル内の特定のページ、名前付きデスティネーション、または構造要素への正確なリンクが実現されます。

PDF用語におけるFragmentとは、PDF文書内の特定の位置を指定するURLまたはデスティネーション文字列の一部を指します。特定のページ番号、名前付きデスティネーション、座標位置、または構造要素を指し示す位置識別子として機能します。Fragmentは、ハッシュ記号（#）の後に記述されるURI形式の参照で最も一般的に使用され、document.pdf#page=5やdocument.pdf#nameddest=Chapter3のような形式で表現されます。

FragmentはHTMLアンカーと概念的に類似していますが、実装方法は異なります。PDFにおけるFragmentは、名前付き位置だけでなく、ページ番号、ズームレベル、ビュー座標によって定義された明示的なデスティネーションも参照できます。これにより、Fragmentは単純なHTMLアンカーよりも汎用性が高く、PDFを開いた際の位置と表示状態の両方を制御できます。

PDF統合に取り組む開発者にとって、Fragmentの理解は、正確なナビゲーションとディープリンク機能を実装するために不可欠です。Fragmentにより、アプリケーションは長大な文書内の特定のコンテンツにユーザーを直接誘導でき、手動スクロールや検索を不要にすることでユーザーエクスペリエンスを向上させます。これは、ウェブアプリケーション、文書管理システム、アクセシビリティツールなど、ユーザーが関連セクションに素早くアクセスする必要がある場合に特に有用です。

PDFを生成または操作するアプリケーションを開発する際、適切なFragment実装により、リンクが機能し続け、ユーザーが文書コンテンツへの正確な参照を共有できることが保証されます。この機能は、共同作業ワークフロー、法的文書の参照、引用システム、および複雑な文書構造のナビゲーションを支援するアクセシビリティ機能において極めて重要です。

PDFにおけるFragmentは、PDF仕様書で定義されたデスティネーションメカニズムを通じて機能します。PDFビューアがFragment識別子を含むURIに遭遇すると、Fragmentを解析してターゲット位置を特定します。Fragmentは以下の複数の方法でデスティネーションを指定できます。

ページベースのFragmentは、#page=10のような構文を使用して特定のページ番号へナビゲートします。より高度なFragmentには、#page=10&zoom=150のようにズームレベルと表示位置を制御するビューパラメータを含めることができます。

名前付きデスティネーションは、PDF文書構造内で事前定義された識別子を使用します。これらは#nameddest=Introductionのように記述され、文書の名前辞書で定義されたデスティネーションオブジェクトを参照します。名前付きデスティネーションは、文書改訂時にページ番号が変更されても有効であり続けるため、特に有用です。

座標ベースのデスティネーションは、XYZ座標を使用してページ上の正確な位置を指定し、文書を開いた際のビューの正確な配置を可能にします。これらのデスティネーションには、ページの表示方法を制御するフィットオプション（幅に合わせる、高さに合わせる、表示領域に合わせるなど）を含めることができます。

PDFビューアは、文書の内部構造でデスティネーションを検索してFragmentを解決し、指定された位置へナビゲートし、Fragment仕様に含まれるビューパラメータを適用します。

• Destination（デスティネーション） – PDF文書内のターゲット位置を定義するもので、ページ参照とオプションのビューパラメータで構成されます
• Named Destination（名前付きデスティネーション） – 特定のデスティネーションオブジェクトにマッピングされたテキスト文字列識別子で、文書改訂を通じて持続する安定した参照を可能にします
• URI（Uniform Resource Identifier） – リソースを識別する文字列で、PDFコンテキストでは文書内の位置を指定するFragment識別子を含めることができます
• Outline（アウトライン） – 階層的なナビゲーション構造（ブックマークとも呼ばれる）で、デスティネーションを使用して文書セクションにリンクします
• Link Annotation（リンク注釈） – PDF内のインタラクティブ要素で、デスティネーションとFragmentを使用して特定の位置へのナビゲーションを可能にします