Text 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ドキュメント内でのデータ収集とユーザー入力を可能にします。テキストフィールドは、単一行または複数行の入力用に設定でき、フォント、テキスト配置、文字数制限などの様々な書式設定オプションをサポートしています。

テキストフィールドは、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)エントリが「Tx」であるフィールドディクショナリによって表現され、入力動作、外観、検証を制御する様々な属性を含むことができます。

テキストフィールドは、通常のテキスト入力フィールド、パスワードフィールド（入力された文字が隠される）、またはファイル選択フィールドとして設定できます。RichTextフラグが設定されている場合はリッチテキスト書式設定をサポートし、ユーザーがフィールド内でテキストスタイリングを適用できます。フィールドはMaxLenプロパティを通じて文字数制限を強制したり、JavaScriptアクションまたは書式文字列を通じて特定の書式設定を適用したりすることもできます。

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内のテキストフィールドは、その動作と外観を制御するプロパティを含むフィールドディクショナリによって定義されます。ディクショナリには、フィールドタイプ(FT)、フィールド名(T)、フィールド値(V)、デフォルト値(DV)、および複数行入力、パスワードマスキング、スペルチェックなどの特性を制御する様々なフラグといったエントリが含まれます。テキストフィールドの視覚的表現は、ウィジェット注釈を通じて制御され、これによりフィールドのページ上での位置、サイズ、外観が定義されます。

ユーザーがテキストフィールドと対話すると、PDFビューアアプリケーションが入力を管理し、フィールドに関連付けられた文字数制限、書式設定ルール、または検証スクリプトを適用します。入力されたテキストはフィールドの値(V)エントリに保存され、PDFフォームデータ抽出を通じて取得できます。テキストフィールドは、keystroke、format、validate、calculateなどのイベントでJavaScriptアクションをトリガーでき、開発者が複雑なフォームロジックとリアルタイムデータ検証を実装できるようにします。

テキストフィールドは、フィールドコンテンツのレンダリング方法を定義する外観ストリームを通じて様々な書式設定オプションをサポートします。デフォルト外観(DA)文字列は、テキストのフォント、サイズ、色を指定します。複数行テキストフィールドの場合、テキストはフィールド境界内で自動的に折り返され、単一行フィールドの場合はテキストが表示幅を超えると水平方向にスクロールします。 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) で説明されているTagged PDFを扱う場合、テキストフィールドは論理的な読み順とアクセシビリティを維持するために、ドキュメントの構造ツリーに適切に統合される必要があります。

• Form field（フォームフィールド） – PDFフォーム内のインタラクティブな要素の親カテゴリで、テキストフィールド、ボタン、選択フィールドを含む
• Widget annotation（ウィジェット注釈） – PDFページ上にフォームフィールドを表示し、ユーザーとの対話を処理する視覚的コンポーネント
• Field dictionary（フィールドディクショナリ） – フォームフィールドに関連付けられたプロパティ、動作、データを定義するPDFオブジェクト
• AcroForm – ドキュメント内のインタラクティブなフォームフィールドとそのデータを管理するPDFフォームアーキテクチャ
• Tagged PDF – アクセシビリティと論理的なドキュメント構成のためのメタデータを含む構造化されたPDF形式