Button field

ボタンフィールド（Button field）は、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フォームを作成するための基本的なフィールドタイプの1つです。テキスト入力やリストからの選択を受け付けるテキストフィールドや選択フィールドとは異なり、ボタンフィールドはユーザーのクリックに応答し、アクションをトリガーしたり、ブール状態を表現したりすることができます。

ボタンフィールドは、PDF仕様で定義されたインタラクティブなアノテーションで、ユーザーがクリックやトグル操作を通じてドキュメントと対話できるようにします。ボタンフィールドには3つの明確なサブタイプがあります：プッシュボタン（クリック時にアクションを実行）、チェックボックス（オン・オフ状態を切り替え）、ラジオボタン（グループ内の1つのオプションを選択）です。これらのフィールドはPDF構造内で特定のプロパティで定義され、異なる状態（通常、ロールオーバー、押下）での外観を定義するアピアランスストリーム（appearance stream）や、ボタンがアクティブ化されたときに実行されるオプションのアクションが含まれます。フィールドタイプはフィールド辞書内の/FTエントリで/Btnの値により識別され、特定のサブタイプの動作は/Ff（フィールドフラグ）エントリ内のフラグによって制御されます。

ボタンフィールドは、単純な閲覧を超えたユーザーエンゲージメントを必要とするインタラクティブなPDFフォームやドキュメントを作成するために不可欠です。PDF対応アプリケーションを構築する開発者にとって、ボタンフィールドの理解は、フォーム送信ワークフロー、ナビゲーションコントロール、ドキュメントの使いやすさを向上させるインタラクティブ機能を実装するために重要です。ボタンフィールドは、 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) に従って適切にタグ付けされると、支援技術がフォームコントロールを正しく識別して対話できるようにする重要なアクセシビリティ機能を提供します。また、ユーザーのインタラクションがJavaScriptアクションをトリガーしたり、異なるページに移動したり、サーバーにデータを送信したり、ドキュメントの状態を変更したりできる動的なPDFを作成するための基盤を提供します。PDF機能を統合するWeb開発者にとって、ボタンフィールドは従来のHTMLフォームコントロールとPDFのインタラクティビティの間の橋渡しをします。

ボタンフィールドは、PDF構造内で定義されたアピアランス辞書とオプションアクションの組み合わせによって動作します。各ボタンフィールドには、異なる状態でのボタンのレンダリング方法を指定するアピアランス辞書（/AP）が含まれています：通常（/N）、ロールオーバー（/R）、押下（/D）です。フィールドフラグ（/Ff）エントリはボタンの動作を決定します。例えば、プッシュボタンフラグ（ビット17）は、フィールドがチェックボックスやラジオボタンではなくプッシュボタンとして動作することを示し、ラジオフラグ（ビット16）とno-toggle-to-offフラグ（ビット15）を組み合わせると、グループ内の1つのボタンのみを選択できるラジオボタンの動作が作成されます。ユーザーがボタンフィールドと対話すると、PDFビューアは/A（アクション）エントリで定義された関連アクションを処理します。これには、フォームデータの送信、フィールドのリセット、JavaScriptの実行、URLへのナビゲーションなどが含まれます。ラジオボタンは共通のフィールド名を共有してグループ化され、それぞれが選択されたオプションを識別する一意のエクスポート値を持ちます。チェックボックスは独立したオン・オフ状態を維持し、チェック済み・未チェック状態の両方にカスタマイズされたアピアランスストリームを持つことができます。

• Form field（フォームフィールド） – ボタン、テキスト、選択、署名フィールドを含むPDFドキュメント内のインタラクティブ要素の親カテゴリ
• Annotation（アノテーション） – PDFにおける視覚的要素で、インタラクティブにすることができ、特殊化されたサブタイプとしてフォームフィールドを含む
• Appearance stream（アピアランスストリーム） – PDFビューアでフォームフィールドやアノテーションがどのようにレンダリングされるかを定義するグラフィカルコンテンツ
• Field flags（フィールドフラグ） – ボタン固有の設定を含む、フォームフィールドの動作とプロパティを制御するバイナリフラグ
• Tagged PDF（タグ付きPDF） – コンテンツに関するセマンティック情報を含む構造化されたPDFフォーマットで、インタラクティブフォームをアクセシブルにするために不可欠 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ )