Eingabefeld - FORMCYCLE Wiki

author	version	line-number	content
1	{{panel float="right"}}
2	(% class="block text-align-center%){{ficon name="XTextfield" size="4em"/}}
3
4	(% class="block%)Das Symbol für Elemente vom Type //Eingabefeld//.
5	{{/panel}}
6
7	== Funktionsweise ==
8
9	Das Formularelement //Eingabefeld// fügt ein einzeiliges Eingabefeld in das aktuelle Formular ein. Über die [[Elementeigenschaft //Label//>>doc:Formcycle.FormDesigner.ElementProperties.Label]] kann das Formularelement auch mit einer Überschrift beschriftet werden. Weiterhin kann über die Elementeigenschaft //Maskieren// die Eingabe wie bei einem Passwortfeld maskiert werden.
10
11	{{internBaseOptionsElement page="base"}}
12
13	{{figure image="Eigenschaften_input_0.png" width="200"}}In den Bedingungen kann zusätzlich festgelegt, ob und wann das Eingabefeld ein Mussfeld ist und welchen Datentyp es haben soll.{{/figure}}
14
15	{{internBaseOptionsElement page="cond"}}
16	{{table dataTypeAlpha="0" colWidth="-500"}}
17	\|=Name\|=Beschreibung
18	\|Mussfeld\|Legt fest, ob das Element nicht leer sein darf bzw. eine Auswahl getroffen werden muss. Wird diese Option ausgewählt, wird dem Element automatisch ein roter Stern ((% style="color: rgb(255, 0, 0);" %)*(%%)) hinzugefügt.
19	\|Mussfeldgruppe\|Nur verfügbar, wenn //Mussfeld// ausgewählt ist. Legt die Mussfeldgruppe fest, zu der das Element gehören soll. Wenn zwei oder mehr Elemente zu einer Mussfeldgruppe gehören, muss mindestens eines davon einen Wert haben, alle anderen müssen aber nicht ausgefüllt werden.
20	\|Datentyp\|Legt den Datentyp des Elements fest. Der Datentyp ist auch automatisch ein Validator. Wird als Datentyp //Datum// gewählt, so öffnet sich bei Klick in das Feld ein sogenannter //[[Datepicker>>doc:Main.Datepicker]]// zur Auswahl des Datums.
21	Nähere Beschreibungen zu den Datentypen finden Sie im [[Abschnitt Validatoren>>doc:Validatoren]].
22	Zur Formattierung von Zahlen mit Einheiten wie //€// oder //kg// und einstellbaren Dezimaltrennzeichen kann die Funktion [[autoNumeric im Skriptbereich>>doc:Zahlenformat (AutoNumeric)]] verwendet werden.
23	Weiterhin kann durch Auswahl des Datentyp //Regulärer Ausdruck// auch eine eigene //RegExp// für die Validierung verwendet werden. Im Feld //Fehlertext// kann dann der Text eingetragen werden, der erscheint, wenn das Formularfeld nicht gültig ist. Der Fehlertext kann per [[Internationalisierung>>doc:Internationalisierung]] in verschiedene Sprachen übersetzt werden. Es werden hierbei reguläre Ausdrücke von Javascript wie bei [[mozilla.org>>url:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions]] beschrieben verwendet.
24	\|Min. Zeichen\|Legt die Anzahl der mindestens einzugebenden Zeichen fest.
25	\|Max. Zeichen\|Legt die Anzahl der maximal einzugebenden Zeichen fest.
26	\|Mindestwert\|Mindestwert, den die Eingabe haben muss. Nur bei den Datentypen //Ganzzahl//, //Positive Ganzzahl//, //Zahl//, //Geldbetrag//, //Positiver Geldbetrag// und //Positiver Geldbetrag (Nachkommastellen opt.)// verfügbar.
27	\|Maximalwert\|Maximalwert, den die Eingabe haben darf. Nur bei den Datentypen //Ganzzahl//, //Positive Ganzzahl//, //Zahl//, //Geldbetrag//, //Positiver Geldbetrag// und //Positiver Geldbetrag (Nachkommastellen opt.)// verfügbar.
28	\|Identisch mit\|Über die Auswahl //Identisch mit// wird festgelegt, dass der Wert des Elements mit dem Wert des ausgewählten Elements übereinstimmen muss.
29	{{/table}}
30	{{/internBaseOptionsElement}}
31
32	{{internBaseOptionsElement page="label"}}
33
34	{{figure image="Eigenschaften_input_1.png" width="200"}}Bei einem Eigabefeld kann zusätzlich noch festgelest werden, ob das Feld bereits einen Wert beim Formularaufruf haben soll und ob die Eingabe maskiert erscheinen soll.{{/figure}}
35
36	{{figure image="eigenschaften_input_2.png" }}Ist ein Eingabefeld maskiert, wird die Eingabe unkenntlich gemacht. Dies kann etwa für Passwortfelder genutzt werden.{{/figure}}
37
38	{{internBaseOptionsElement page="val"}}
39	{{table dataTypeAlpha="0" colWidth="-500"}}
40	\|=Name\|=Beschreibung
41	\|Wert\|Initialer Wert des Elements.
42	\|Maskieren\|Maskieren der eingegebene Werte. Wird typischerweise bei Passwortfeldern eingesetzt.
43	{{/table}}
44	{{/internBaseOptionsElement}}
45
46	{{internBaseOptionsElement page="css"/}}
47
48	{{internBaseOptionsElement page="attr"/}}
49
50	{{internBaseOptionsElement page="avail"/}}
51
52	{{internBaseOptionsElement page="ronly"/}}
53
54	{{internBaseOptionsElement page="misc"/}}
55
56	{{content moveToTop="true"/}}
57	{{/internBaseOptionsElement}}
58	{{/internBaseOptionsElement}}
59	{{/internBaseOptionsElement}}

1

2

(% class="block text-align-center%){{ficon name="XTextfield" size="4em"/}}

3

4

(% class="block%)Das Symbol für Elemente vom Type //Eingabefeld//.

== Funktionsweise ==

Das Formularelement //Eingabefeld// fügt ein einzeiliges Eingabefeld in das aktuelle Formular ein. Über die [[Elementeigenschaft //Label//>>doc:Formcycle.FormDesigner.ElementProperties.Label]] kann das Formularelement auch mit einer Überschrift beschriftet werden. Weiterhin kann über die Elementeigenschaft //Maskieren// die Eingabe wie bei einem Passwortfeld maskiert werden.

{{figure image="Eigenschaften_input_0.png" width="200"}}In den Bedingungen kann zusätzlich festgelegt, ob und wann das Eingabefeld ein Mussfeld ist und welchen Datentyp es haben soll.{{/figure}}

|=Name|=Beschreibung

|Mussfeld|Legt fest, ob das Element nicht leer sein darf bzw. eine Auswahl getroffen werden muss. Wird diese Option ausgewählt, wird dem Element automatisch ein roter Stern ((% style="color: rgb(255, 0, 0);" %)*(%%)) hinzugefügt.

19

|Mussfeldgruppe|Nur verfügbar, wenn //Mussfeld// ausgewählt ist. Legt die Mussfeldgruppe fest, zu der das Element gehören soll. Wenn zwei oder mehr Elemente zu einer Mussfeldgruppe gehören, muss mindestens eines davon einen Wert haben, alle anderen müssen aber nicht ausgefüllt werden.

20

|Datentyp|Legt den Datentyp des Elements fest. Der Datentyp ist auch automatisch ein Validator. Wird als Datentyp //Datum// gewählt, so öffnet sich bei Klick in das Feld ein sogenannter //[[Datepicker>>doc:Main.Datepicker]]// zur Auswahl des Datums.

21

Nähere Beschreibungen zu den Datentypen finden Sie im [[Abschnitt Validatoren>>doc:Validatoren]].

22

Zur Formattierung von Zahlen mit Einheiten wie //€// oder //kg// und einstellbaren Dezimaltrennzeichen kann die Funktion [[autoNumeric im Skriptbereich>>doc:Zahlenformat (AutoNumeric)]] verwendet werden.

23

Weiterhin kann durch Auswahl des Datentyp //Regulärer Ausdruck// auch eine eigene //RegExp// für die Validierung verwendet werden. Im Feld //Fehlertext// kann dann der Text eingetragen werden, der erscheint, wenn das Formularfeld nicht gültig ist. Der Fehlertext kann per [[Internationalisierung>>doc:Internationalisierung]] in verschiedene Sprachen übersetzt werden. Es werden hierbei reguläre Ausdrücke von Javascript wie bei [[mozilla.org>>url:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions]] beschrieben verwendet.

24

|Min. Zeichen|Legt die Anzahl der mindestens einzugebenden Zeichen fest.

25

|Max. Zeichen|Legt die Anzahl der maximal einzugebenden Zeichen fest.

26

|Mindestwert|Mindestwert, den die Eingabe haben muss. Nur bei den Datentypen //Ganzzahl//, //Positive Ganzzahl//, //Zahl//, //Geldbetrag//, //Positiver Geldbetrag// und //Positiver Geldbetrag (Nachkommastellen opt.)// verfügbar.

27

|Maximalwert|Maximalwert, den die Eingabe haben darf. Nur bei den Datentypen //Ganzzahl//, //Positive Ganzzahl//, //Zahl//, //Geldbetrag//, //Positiver Geldbetrag// und //Positiver Geldbetrag (Nachkommastellen opt.)// verfügbar.

28

|Identisch mit|Über die Auswahl //Identisch mit// wird festgelegt, dass der Wert des Elements mit dem Wert des ausgewählten Elements übereinstimmen muss.

{{figure image="Eigenschaften_input_1.png" width="200"}}Bei einem Eigabefeld kann zusätzlich noch festgelest werden, ob das Feld bereits einen Wert beim Formularaufruf haben soll und ob die Eingabe maskiert erscheinen soll.{{/figure}}

35

36

{{figure image="eigenschaften_input_2.png" }}Ist ein Eingabefeld maskiert, wird die Eingabe unkenntlich gemacht. Dies kann etwa für Passwortfelder genutzt werden.{{/figure}}

|=Name|=Beschreibung

|Wert|Initialer Wert des Elements.

42

|Maskieren|Maskieren der eingegebene Werte. Wird typischerweise bei Passwortfeldern eingesetzt.

43

44

45