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 |
jitMasking
Just in time masking. Die Maskierung wird während der Eingabe durchgeführt.
Default: false
autoUnmask
Die Eingabe wird bei der Übermittlung unmaskiert.
Default: false
Weitere Maskierungsmöglichkeiten und Optionen sind unter der folgenden URL zu finden: