フォームリセットアクション(ResetForm action)
ResetFormアクションは、で定義されているインタラクティブなアクションタイプで、PDF文書内のフォームフィールドをデフォルト値に復元します。
ResetFormアクションは、 ( 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文書内のフォームフィールドをデフォルト値に復元します。ユーザーの操作またはプログラムによる実行でトリガーされると、このアクションはユーザーが入力したデータをクリアし、指定されたフィールドを元の状態に戻します。このアクションタイプはフォームの使いやすさにとって不可欠な機能を提供し、ユーザーが文書を閉じることなく誤った入力をクリアしたり、最初からやり直したりすることを可能にします。
ResetFormアクションは、PDF仕様で利用可能な複数のアクションタイプの1つで、インタラクティブなフォームフィールド(AcroFormフィールド)を特に対象としています。フォームデータを外部の宛先に送信するSubmitFormアクション、またはデータをフォームに読み込むImportDataアクションとは異なり、ResetFormアクションはフィールドディクショナリで定義されたデフォルト値にフィールド値をリセットすることで、完全に文書内で動作します。
このアクションは、PDF構造内では/ResetFormというアクションタイプを持つディクショナリとして表現されます。文書内のすべてのフォームフィールドをリセットするように構成することも、オプションのFields配列エントリを通じて指定されたサブセットのみをリセットするように構成することもできます。このアクションには、指定されたフィールドをリセットするか(デフォルトの動作)、または指定されたフィールド以外のすべてのフィールドをリセットするかを制御するFlagsエントリも含まれています。
(
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
)
によると、デフォルト値は各フィールドディクショナリの/DV(Default Value)エントリに格納されます。フィールドにデフォルト値が定義されていない場合、ResetFormアクションはフィールドを完全にクリアし、空の状態に戻します。
インタラクティブなPDFフォームを作成する開発者にとって、ResetFormアクションは重要なユーザーエクスペリエンス機能を提供します。ユーザーはフォームの入力時に頻繁に間違いを犯したり、すべてのエントリをクリアして最初からやり直したいと思うことがあり、リセットボタンやメカニズムを提供することはフォーム設計における標準的な期待事項です。
開発の観点からは、ResetFormアクションの実装は、個々のフィールドを手動で反復処理してクリアする場合と比較して、最小限のコードで済みます。このアクションはPDFビューアの組み込みフォーム処理機能を活用することで、異なるPDFリーダーやプラットフォーム間で一貫した動作を保証します。この標準化は、PDF/UA準拠の文書が予測可能で適切にラベル付けされたインタラクティブ要素を必要とするため、アクセシビリティの観点から特に重要です。
さらに、選択的なフィールドのリセットにより、開発者はユーザーのアクションに基づいてフォームの一部のみをクリアする高度なフォームワークフローを作成でき、JavaScriptや外部処理を必要とせずに複雑なビジネスロジックをサポートできます。
ResetFormアクションは、PDFのインタラクティブ要素内のディクショナリエントリとして定義され、通常はボタンウィジェットまたはその他のユーザーがアクティブ化するトリガーに関連付けられています。アクションディクショナリには、/ResetFormという値を持つ/S(サブタイプ)エントリが含まれている必要があります。
このアクションは、その動作を制御する2つのオプションエントリをサポートしています:
Fields配列:アクションが影響を与えるフィールドを指定するフィールド参照の配列(完全修飾フィールド名を表すテキスト文字列、またはフィールドディクショナリへの間接参照のいずれか)。このエントリが省略された場合、アクションは文書内のすべてのフィールドに適用されます。
Flags整数:アクションの動作を変更するフラグ値。ビット1がクリア(値0)の場合、Fields配列にリストされているフィールドがリセットされます。ビット1がセット(値1)の場合、リストされているフィールド以外のすべてのフィールドがリセットされ、事実上選択が反転します。
トリガーされると、PDFビューアは対象フィールドを識別し、その値を/DVエントリの内容に設定することでアクションを処理します。デフォルト値のないフィールドについては、ビューアは既存の値を削除します。その後、ビューアは影響を受けたフォームフィールドの視覚的な外観を更新して、リセット状態を反映します。
(
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
)
で指定されているように、このプロセスはフィールド階層を尊重し、親フィールドをリセットすると、フィールドツリー内のすべての子もリセットされます。
- AcroForm – 入力可能なフィールドを持つインタラクティブなフォームを作成するためのPDF技術
- SubmitFormアクション – フォームフィールドデータを指定されたURLまたは宛先に送信するアクション
- ImportDataアクション – 外部のFDFファイルからのデータでフォームフィールドを埋めるアクション
- フォームフィールドディクショナリ – デフォルト値を含むフォームフィールドのプロパティを定義するPDFオブジェクト
- フィールドウィジェット注釈 – ユーザーがページ上で対話するフォームフィールドの視覚的な表現
- (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
