List box

リストボックスは、PDF文書内の選択フォームフィールドの一種で、ユーザーが1つまたは複数の項目を選択できるオプションのリストを視覚的に表示します。クリック時に展開されるドロップダウンメニューとは異なり、リストボックスはスクロール可能な長方形の領域内に複数のオプションを同時に表示します。リストボックスは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 ) においてインタラクティブフォームフィールドとして定義されており、アクセシビリティ準拠のために適切にタグ付けされる必要があります。

リストボックスは、縦に配置されたリスト形式で複数の選択可能なオプションを表示するフォームフィールドウィジェットです。コンボボックス（ドロップダウンリスト）とは異なり、複数のオプションがアクティブ化されるまで非表示になるのではなく、常に表示されている点が特徴です。リストボックスは、単一選択（新しいオプションを選択すると前の選択が解除される）またはマルチ選択モード（通常はCtrl+クリックまたはShift+クリックを使用して、ユーザーが複数の項目を同時に選択できる）のいずれかを許可するように設定できます。フィールドは、コンテンツが表示領域を超える場合にスクロールバーを表示し、ユーザーが利用可能なすべてのオプションをナビゲートできるようにします。PDF構造では、リストボックスはフィールドタイプが「Ch」（choice）のウィジェット注釈として表現され、フラグ値によって特定の動作が決定されます。

インタラクティブ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 ) 。リストボックスはフォームのユーザビリティに関する意思決定に影響を与えます。リストボックスとコンボボックスのどちらを選択するかは、文書のレイアウトスペース、ユーザーのインタラクションパターン、フォーム入力の効率性に影響します。また、開発者は、アプリケーションでPDFフォームを処理する際に、リストボックスフィールドからデフォルト値をプログラムで設定し、選択を検証し、ユーザーが送信したデータを抽出する方法を理解する必要があります。

PDFのリストボックスは、外観と動作を制御する特定の属性を持つフォームフィールドディクショナリとして実装されます。フィールドディクショナリには、選択フィールドを示す「Ch」に設定されたFT（フィールドタイプ）エントリと、フィールドがリストボックスとして動作するかコンボボックスとして動作するかを決定するFf（フィールドフラグ）エントリが含まれます。適切なフラグが設定されると、フィールドはドロップダウンではなくリストボックスとしてレンダリングされます。フィールドディクショナリのOptエントリには、利用可能なオプションの配列が含まれており、これは単純なテキスト文字列、または表示テキストとエクスポート値をペアにした配列のいずれかです。マルチ選択リストボックスの場合、V（値）エントリには単一の値ではなく、選択された項目の配列を含めることができます。リストボックスの外観は、アピアランスストリームとウィジェット注釈の矩形座標によって制御され、可視領域を定義します。アクセシビリティ ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) のために、リストボックスは文書のタグツリー内の適切な構造要素と関連付けられる必要があり、通常は適切なロールマッピングと代替説明を使用して、支援技術がフィールドの目的を解釈し、その状態をユーザーに伝えられるようにします。

• Form field（フォームフィールド） – ユーザー入力を収集するPDF内のインタラクティブ要素
• Combo box（コンボボックス） – アクティブ化された場合にのみオプションを表示するドロップダウン選択フィールド
• Widget annotation（ウィジェット注釈） – PDFページ上のインタラクティブフォームフィールドの視覚的表現
• Choice field（選択フィールド） – 事前定義されたオプションから選択できるフォームフィールドの一般的なカテゴリ
• Tagged PDF – アクセシビリティとコンテンツの再利用のためのセマンティックマークアップを含むPDF文書構造