commitOn

Gibt an, wann die Auswahl eines Benutzers auf das Datenmodell übertragen wird.

Syntax

Reference_Syntax.commitOn = "select | exit"

Werte

Typ

Werte

Zeichenfolge

  • auswählen

  • exit

Wenn ein Benutzer einen Auswahllisteneintrag mit der Tastatur oder der Maus auswählt, werden die ausgewählten Daten in das Datenmodell geschrieben.

Es kann vor allem bei Formularen, die interaktive Nicht-XFA-Funktionen enthalten, wie Acrobat-Kommentare oder Hypertext-Verknüpfungen, wichtig sein, dass Daten aus einer Auswahlliste sofort nach der Auswahl übergeben werden. Benutzer, die solche Formulare ausfüllen, könnten irrtümlicherweise meinen, dass das Auswählen eines Elements aus einer Auswahlliste und das anschließende Klicken auf eine interaktive nicht-XFA-Funktion dem Beenden der Auswahlliste entspricht. Tatsächlich bleibt der Fokus jedoch auf der Auswahlliste.

  • exit

Die ausgewählten Daten werden erst in das Datenmodell geschrieben, wenn das Feld den Fokus verliert. Diese Einstellung ist für Auswahllisten empfehlenswert, die mehrere Auswahlen unterstützen (open="multiSelect").

Gilt für

Modell

Objekt

Formularmodell

choiceList

Version

XFA 2.2

Beispiele

JavaScript

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

FormCalc

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