Pushbutton

Pushbuttonは、PDF文書におけるボタンフィールドの特殊なサブタイプで、ユーザーがクリックすると特定のアクションを実行します。チェックボックスやラジオボタンなどの状態を保持する他のボタンフィールドタイプとは異なり、pushbuttonはデータを保存するのではなく、純粋にアクションをトリガーするために設計されています ( 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文書内では、ナビゲーション、フォーム送信、フォームのリセット、JavaScriptコードの実行などに一般的に使用されます。

Pushbuttonは、PDF仕様で定義されている3つのボタンフィールドサブタイプの1つで、チェックボックスやラジオボタンと並んで存在します。チェックボックスとラジオボタンが二値選択や複数選択肢のユーザー選択を取得・保持するために設計されているのに対し、pushbuttonはまったく異なる目的を果たします。状態情報を保持せず、アクションのトリガーとして機能します ( 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 ) 。

Pushbuttonフィールドは、FT（フィールドタイプ）エントリをBtnに設定し、Ff（フィールドフラグ）エントリをチェックボックスやラジオボタンではなく、特にpushbuttonであることを示すように構成して定義されます。ユーザーがpushbuttonを操作すると、通常、その/A（アクション）辞書で定義されたアクションが実行されます。これには、フォームデータをURLに送信する、別のページや文書にナビゲートする、JavaScriptを実行する、フォームフィールドをデフォルト値にリセットするなどのアクションが含まれます。

チェック状態と未チェック状態を切り替えるチェックボックスとは異なり、pushbuttonはクリックされた直後にデフォルトの外観に戻り、操作中のみ一時的な視覚的フィードバックを提供します。

PDF文書を扱う開発者にとって、pushbuttonはユーザー主導のワークフローと動的な動作を可能にする不可欠なインタラクティブ要素です。PDFフォームやインタラクティブ文書内でユーザーがアクションを開始するための主要なメカニズムを提供し、機能的なビジネスプロセス、データ収集システム、文書ワークフローを作成するために重要です。

Pushbuttonの理解は、アクセシブルなPDF文書を開発する際に特に重要です。支援技術を使用するユーザーがpushbuttonを理解し操作できるように、適切なラベル、ツールチップ、代替テキストで正しく構成する必要があります ( 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 ) 。フォーム送信ワークフローを実装する開発者は、バックエンドシステムにデータが確実に送信されるよう、pushbuttonを正しく構成する必要があります。

Tagged PDF文書では、アクセシビリティと文書の整合性を維持するために、pushbuttonを文書の論理階層内に適切に構造化する必要があります ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) 。これには、スクリーンリーダーに依存するユーザーを含むすべてのユーザーにその目的を伝える、適切なロールマッピングと説明的なコンテンツを確保することが含まれます。

技術的なレベルでは、pushbuttonは特定のフィールドプロパティを持つアノテーション辞書として実装されます。アノテーションには以下を含める必要があります：

• フィールドタイプ（FT）：ボタンフィールドであることを識別するために/Btnに設定
• フィールドフラグ（Ff）：チェックボックスやラジオボタンと区別するために構成（pushbuttonの場合、ビット16はクリアし、ビット15を設定する必要があります）
• アクション辞書（/A）：ボタンがアクティブ化されたときに何が起こるかを定義します（submit-formアクション、URIアクション、JavaScriptアクション、名前付きアクションなど）
• 外観ストリーム（/AP）：ボタンの通常状態、ロールオーバー状態、ダウン状態での視覚的表現を定義

ユーザーがpushbuttonを操作すると、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 ) 。例えば、submit-formアクションはフォームフィールドからデータを収集し、指定されたURLに送信します。一方、reset-formアクションは指定されたフィールドをデフォルト値に復元します。

Pushbuttonの外観は、異なる操作状態でどのように見えるかを定義する外観ストリームを使用してカスタマイズできます。開発者は、カスタムグラフィックス、テキストラベル、アイコン、またはこれらの組み合わせを指定できます。ボタンには、ページ内での位置、サイズ、視覚的境界を定義するウィジェットアノテーションも含めることができます。

適切なアクセシビリティを確保するために、pushbuttonには/TU（ツールチップ）エントリや/T（フィールド名）エントリなどの説明的なプロパティを含める必要があり、支援技術がユーザーにそれを識別し説明できるように、文書の構造ツリー内に適切にタグ付けする必要があります。

• Button Field – pushbutton、チェックボックス、ラジオボタンを含むインタラクティブフォームフィールドの親カテゴリ
• Form Field – ユーザーがデータを入力または選択できるPDF文書内のインタラクティブ要素
• Action Dictionary – ユーザーの操作や文書イベントに応答して実行される操作を定義するPDFオブジェクト
• Widget Annotation – pushbuttonを含む、PDFページ上のフォームフィールドの視覚的表現
• Submit-form Action – フォームデータを指定された宛先に送信する、pushbuttonに一般的に関連付けられる特定のアクションタイプ