Freitext (Standardformularfeld)

Die Grundlage der meisten Formulare sind klassische Eingabefelder, um Angaben zu erfassen. In JAXForms werden diese Felder "Freitext" genannt. Nicht zu verwechseln mit Anzeigetext (Reiner HTML Text zur Ausgabe im Formular).

Folgende Felder sind in der Regel mit dem Typ "Freitext" umgesetzt:

large = Info Feldgrösse

Konfiguration

1. Als Text anzeigen

Wird diese Option gewählt, zeigt sich das Feld nicht als Formularfeld, sondern als Ausgabetext. Das wird verwendet, wenn der Wert schon über Initialwert gesetzt wurde. Der Initialwert wird dabei entweder manuell oder dynamisch, z.B. aus einer Eingabe in einem vorhergehenden Schritt, gesetzt.

2. Als versteckt ("hidden") anzeigen?

Wird diese Option gewählt, blendet es das Eingabefeld aus. Dies kann verwendet werden, um Daten auf dem Formular zu hinterlegen als Metadaten oder Zwischenablage von Werten.

3. Max. Anzahl Zeichen

Definiert die maximale Anzahl Zeichen (inkl. Leerschläge), welche in diesem Feld erfasst werden dürfen / können. Beim Freitext-Typ, ohne Anzeige der verwendeten Zeichen.

4. Breite

Definiert die Anzeigebreite. Die effektiven Breiten (% oder Wert) der angebotenen Auswahl wird im Style-Sheet (CSS) definiert. Siehe Beispiel am Anfang der Seite.

5. JSON Konfiguration

Eingabemöglichkeit für JSON Konfiguration. Wird z.B. verwendet, wenn die Eingabe durch eine Funktion mit einer erweiterten Verifizierung geprüft werden soll. Zum Beispiel Prüfziffer-Verifizierung bei IBAN oder ZPV-Nr.

6. Maskierung

Input-Elemente vom Typ Text können mit einer Eingabemaskierung eingeschränkt werden.

Folgende Syntax kann für das Feld "Maskierung" verwendet werden:

Statische Masken:

9 : nummerisch
a : alphabetisch
* : alphanummerisch

Beispiele:

Pattern	Maskierte Eingabe
999 999 999 999	123 456 789 012
9a9-a9a	1c2-w3f
*..**	s23.121.aa1 1dd.32q.11a

Hinweis

Für eine formatierte Eingabe von Währungen wie CHF ist der Feldtyp "Zahl" mit der Option "Als Betrag anzeigen" zu verwenden.

Optionale Masken

Die Verwendung von [ ] erlaubt eine optionale Eingabe

Beispiele:

Pattern	Maskierte Eingabe
(99) 9999[9]-9999	(12) 3456-7890 (12) 34567-8901

Dynamische Masken

Die Verwendung von { } erlaubt eine dynamische Eingabe

Beispiele

Pattern	Maskierte Eingabe
aa-9{1,4}	ab-1 cd-234

Weitere Möglichkeiten

Weitere Optionen zur Konfiguration können via JSON-Konfiguration übergeben werden:

WO	WERT	OUTPUT
Fragetyp/JSON Konfiguration	{'jitMasking':true, 'autoUnmask':true}
Fragetyp/Maskierung	+99 99 999 99 99

Eingabe nur Zahlen und Textzeichen

Pattern:

*{1,99} maximal 99 Zeichen

*{1,} nicht eingeschränkte Anzahl Zeichen

jitMasking

Just in time masking. Die Maskierung wird während der Eingabe durchgeführt.

Default: false

autoUnmask

Die Eingabe wird bei der Übermittlung unmaskiert.