commitOn

ユーザーの選択をデータモデルに反映させるタイミングを指定します。

構文

Reference_Syntax.commitOn = "select | exit"

文字列

  • select

  • exit

選択したデータは、ユーザーがキーボードまたはマウスを使用して選択リストエントリを選択したときに、データモデルに書き込まれます。

選択リストのデータを選択と同時に送信することは、Acrobat の注釈やハイパーテキストリンクなどの XFA 以外のインタラクティブ機能を含むフォームで重要な場合があります。そのようなフォームに入力するユーザーは、選択リストから項目を選択し、次に XFA 以外のインタラクティブ機能をクリックすることは、チェックリストを閉じる動作と同じであると誤解している場合があります。実際は、チェックリストはフィールドにフォーカスが置かれたままになります。

  • exit

選択したデータは、フィールドのフォーカスが失われるまで、データモデルに書き込まれません。これは複数選択(open="multiSelect")をサポートする選択リストに推奨される設定です。

適用先

モデル

オブジェクト

フォームモデル

choiceList

バージョン

XFA 2.2

JavaScript

DropDownList1.resolveNode("ui.#choiceList").commitOn = "exit";

FormCalc

DropDownList1.ui.#choiceList.commitOn = "exit"