Radio button

ラジオボタンは、PDFドキュメントにおけるボタンフォームフィールドの特殊なサブタイプで、事前に定義された相互排他的な選択肢のグループから、ユーザーが正確に1つのオプションを選択できるようにします。 ( 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 ) で定義されているように、ラジオボタンはインタラクティブなフォーム要素として機能し、1つのボタンを選択すると同じグループ内の他のすべてのボタンが自動的に選択解除されます。この「複数の選択肢から1つ」という選択メカニズムは、データ収集やデジタルワークフローのための構造化されたユーザーフレンドリーなPDFフォームを作成する上で基本となります。

ラジオボタンは、PDF仕様で定義されたボタンフィールドのサブタイプで、フォーム内で相互排他的な選択動作を実装します。複数の独立した選択を許可するチェックボックスとは異なり、ラジオボタンは名前付きグループ内で常に1つのボタンのみが選択できるように設計されています。ユーザーがラジオボタンをクリックすると、同じグループ内で以前に選択されていたボタンは自動的に選択解除されます。

PDF構造において、ラジオボタンはグループ化動作を定義する特定のフラグとプロパティを持つボタンフィールドとして実装されます。複数のラジオボタンウィジェットが同じフィールド名を共有することで、相互排他性が確立されます。同一のフィールド名を持つすべてのウィジェットが、1つのラジオボタングループを形成します。グループ内の各個別オプションは、フォームが送信または処理されるときに選択された選択肢を表す固有のエクスポート値を持ちます。

ラジオボタンは、プッシュボタン（アクションをトリガーする）やチェックボックス（複数のオプションに対して独立したオン/オフ状態を許可する）とは異なります。主な識別特性は、同じフィールド名を共有するすべてのボタンに対して強制される単一選択制約です。

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 ) などの標準に準拠したアクセシブルなPDFフォームを作成する際、適切に設定されたラジオボタングループは、支援技術が障害を持つユーザーに選択メカニズムを正確に伝えることを保証します。スクリーンリーダーは、正しいフィールドのグループ化とラベル付けに依存して、ユーザーが相互排他的なオプションのセットから選択していることをアナウンスします。

PDFフォームをWebアプリケーションやエンタープライズシステムに統合する開発者にとって、ラジオボタンはHTMLフォームコントロールと一致する馴染みのあるインターフェースパターンを提供し、異なるドキュメント形式間で一貫したユーザーエクスペリエンスを作成しやすくします。各ラジオボタンオプションに関連付けられたエクスポート値は、バックエンドデータベースや処理システムとの直接的なデータ抽出と統合を容易にします。

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 ) で指定されているフィールド辞書、ウィジェット注釈、アピアランスストリームの組み合わせによって実装されます。技術的な実装には、いくつかの重要なコンポーネントが含まれます：

フィールド構造: グループ内のすべてのラジオボタンは、共通のフィールド名を持つ単一の親フィールドオブジェクトを共有します。各個別のラジオボタンオプションは、この親フィールドの子としてウィジェット注釈で表現されます。親フィールドの/FT（フィールドタイプ）エントリは/Btn（ボタン）に設定され、/Ff（フィールドフラグ）にはチェックボックスやプッシュボタンではなくラジオボタンの動作を示すためにRadioフラグ（ビット16）を含める必要があります。

エクスポート値: ラジオボタングループ内の各ウィジェットは、それが表すオプションを識別する固有のアピアランス状態名（エクスポート値）を持ちます。ラジオボタンが選択されると、そのアピアランス状態はこの固有の値に設定され、グループ内の他のすべてのボタンは/Off状態に戻ります。これらのエクスポート値は、フォームデータが送信または処理されるときに抽出されるものです。

アピアランスストリーム: 各ラジオボタンウィジェットには、選択状態と非選択状態でボタンがどのようにレンダリングされるかを定義するアピアランスストリームが含まれます。/AP（アピアランス）辞書には、少なくとも通常アピアランス（/N）が含まれ、各状態のサブ辞書があります。通常、選択状態にはボタンの固有のエクスポート値、非選択状態には/Offが使用されます。

選択動作: ユーザーがラジオボタンと対話すると、PDFプロセッサは親フィールドの/V（値）エントリを選択されたウィジェットのエクスポート値と一致するように更新し、グループ内のすべてのウィジェットがそれに応じてアピアランス状態を更新するようトリガーし、関連するJavaScriptやフィールド計算アクションを実行します。

PDFフォームをプログラム的に作成または操作する開発者向けに、ライブラリは通常、フィールド名、エクスポート値を持つ利用可能なオプション、デフォルトの選択状態を指定してラジオボタングループを作成するAPIを提供し、基礎となるフィールド階層やアピアランスストリーム管理を抽象化します。

• Button field（ボタンフィールド） – ラジオボタン、チェックボックス、プッシュボタンを包含する親フォームフィールドタイプ
• Checkbox（チェックボックス） – 相互排他性なしに独立したオン/オフ選択を許可するボタンフィールドのサブタイプ
• Form field（フォームフィールド） – ユーザー入力とデータを収集するPDFドキュメント内のインタラクティブ要素
• Widget annotation（ウィジェット注釈） – ユーザーがPDFページ上で対話するフォームフィールドの視覚的表現
• Export value（エクスポート値） – 送信または抽出される、選択されたフォームフィールドオプションに関連付けられたデータ値