formcycle 8.4.0 - JavaScript für Formulare
    Bereite Suchindex vor...

    Schnittstelle FieldValidationsDescriptor

    Die Konfiguration, die die Validierungsregeln beschreibt, die auf ein bestimmtes Formularelement angewendet werden sollen.

    interface FieldValidationsDescriptor {
        hif?: string;
        hif_c?: string;
        hif_cl?: string;
        hif_v?: string;
        hnotif?: string;
        roif?: string;
        roif_c?: string;
        roif_cl?: string;
        roif_v?: string;
        rom?: string;
        ronotif?: string;
        vcmn?: string;
        vcmx?: string;
        vdt?: string;
        veq?: string;
        vfex?: string;
        vfmx?: string;
        vgr?: string;
        vmn?: string;
        vmnl?: string;
        vmx?: string;
        vmxl?: string;
        vr?: string;
        vrif?: string;
        vrif_c?: string;
        vrif_v?: string;
        vrmm?: string;
        vrnotif?: string;
        vrule?: string;
    }
    Index

    Eigenschaften

    hif?: string

    Ein Formularelement kann automatisch ausgeblendet werden, basierend auf dem Wert eines anderen Formularelements. Dies ist die ID des anderen (referenzierten) Formularelements. Wenn der Wert dieser Eigenschaft leer ist, wird das Formularelement nicht automatisch ausgeblendet.

    Ähnlich wie hnotif, aber dieses Attribut wird gesetzt, wenn das Formularelement ursprünglich sichtbar ist.

    hif_c?: string

    Ein Formularelement kann automatisch ausgeblendet werden, basierend auf dem Wert eines anderen Formularelements. Dies ist die Bedingung, die auf den Wert des anderen Formularelements angewendet wird. Verfügbare Bedingungstypen sind:

    • 0 (hat einen Wert): Das Formularfeld ist ausgeblendet, wenn das andere Feld nicht leer ist.
    • 1 (gleich): Das Formularfeld ist ausgeblendet, wenn der Wert des anderen Feldes dem hif_v entspricht.
    • 2 (ungleich): Das Formularfeld ist ausgeblendet, wenn der Wert des anderen Feldes nicht dem hif_v entspricht.
    • 3 (entspricht regulärem Ausdruck): Das Formularfeld ist ausgeblendet, wenn das andere Feld dem im hif_v enthaltenen regulären Ausdruck entspricht.
    • 4 (ist kleiner als): Das Formularfeld ist ausgeblendet, wenn der Wert des anderen Feldes kleiner ist als der hif_v.
    • 5 (ist größer als): Das Formularfeld ist ausgeblendet, wenn der Wert des anderen Feldes größer ist als der hif_v.
    • 6 (liegt zwischen): Das Formularfeld ist ausgeblendet, wenn der Wert des anderen Feldes im Bereich liegt, der durch hif_v angegeben ist. Das hif_v muss ein Bereich im Format x-y sein, z.B. 2-37.
    • 7 (ist kleiner oder gleich): Das Formularfeld ist ausgeblendet, wenn der Wert des anderen Feldes kleiner oder gleich dem hif_v ist.
    • 8 (ist größer oder gleich): Das Formularfeld ist ausgeblendet, wenn der Wert des anderen Feldes größer oder gleich dem hif_v ist.
    • 9 (hat keinen Wert): Das Formularfeld ist ausgeblendet, wenn das andere Feld keinen Wert hat.
    hif_cl?: string

    Ein Formularelement kann automatisch ausgeblendet werden, basierend auf dem Wert eines anderen Formularelements. Dies ist ein Flag, das angibt, ob das Formularelement gelöscht wird, wenn es ausgeblendet ist. Kann auf eine der folgenden Optionen gesetzt werden:

    • 0 (behalten): Der Wert des Formularelements wird nicht geändert, wenn es ausgeblendet ist.
    • 1 (löschen): Der Wert des Formularelements wird gelöscht, wenn es ausgeblendet ist. Für Texteingabefelder wird der Wert auf den leeren String gesetzt; für Auswahlfelder werden alle ausgewählten Optionen abgewählt.
    • 2 (zurücksetzen): Der Wert des Formularelements wird auf seinen ursprünglichen Wert zurückgesetzt, wenn es ausgeblendet ist.
    hif_v?: string

    Ein Formularelement kann automatisch ausgeblendet werden, basierend auf dem Wert eines anderen Formularelements. Dies ist der Wert, mit dem das andere Formularelement verglichen wird. Ob diese Eigenschaft erforderlich ist und was sie enthalten muss, hängt von der ausgewählten Bedingung ab, siehe hif_c für weitere Details.

    hnotif?: string

    Ein Formularelement kann automatisch ausgeblendet werden, basierend auf dem Wert eines anderen Formularelements. Dies ist die ID des anderen (referenzierten) Formularelements. Wenn der Wert dieser Eigenschaft leer ist, wird das Formularelement nicht automatisch ausgeblendet.

    Ähnlich wie hif, aber dieses Attribut wird gesetzt, wenn das Formularelement ursprünglich ausgeblendet ist.

    roif?: string

    Ein Formularelement kann automatisch deaktiviert werden, basierend auf dem Wert eines anderen Formularelements. Wenn ein Formularfeld deaktiviert ist, kann sein Wert nicht mehr geändert werden. Dies ist die ID des anderen (referenzierten) Formularelements. Wenn der Wert dieser Eigenschaft leer ist, wird das Formularelement nicht automatisch deaktiviert.

    Ähnlich wie roif, aber dieses Attribut wird gesetzt, wenn das Formularelement ursprünglich bearbeitbar ist.

    roif_c?: string

    Ein Formularelement kann automatisch deaktiviert werden, basierend auf dem Wert eines anderen Formularelements. Wenn ein Formularfeld deaktiviert ist, kann sein Wert nicht mehr geändert werden. Dies ist die Bedingung, die auf den Wert des anderen Formularelements angewendet wird. Verfügbare Bedingungstypen sind:

    • 0 (hat einen Wert): Das Formularfeld ist schreibgeschützt, wenn das andere Feld nicht leer ist.
    • 1 (gleich): Das Formularfeld ist schreibgeschützt, wenn der Wert des anderen Feldes dem roif_v entspricht.
    • 2 (ungleich): Das Formularfeld ist schreibgeschützt, wenn der Wert des anderen Feldes nicht dem roif_v entspricht.
    • 3 (entspricht regulärem Ausdruck): Das Formularfeld ist schreibgeschützt, wenn das andere Feld dem im roif_v enthaltenen regulären Ausdruck entspricht.
    • 4 (ist kleiner als): Das Formularfeld ist schreibgeschützt, wenn der Wert des anderen Feldes kleiner ist als der roif_v.
    • 5 (ist größer als): Das Formularfeld ist schreibgeschützt, wenn der Wert des anderen Feldes größer ist als der roif_v.
    • 6 (liegt zwischen): Das Formularfeld ist schreibgeschützt, wenn der Wert des anderen Feldes im Bereich liegt, der durch roif_v angegeben ist. Das roif_v muss ein Bereich im Format x-y sein, z.B. 2-37.
    • 7 (ist kleiner oder gleich): Das Formularfeld ist schreibgeschützt, wenn der Wert des anderen Feldes kleiner oder gleich dem roif_v ist.
    • 8 (ist größer oder gleich): Das Formularfeld ist schreibgeschützt, wenn der Wert des anderen Feldes größer oder gleich dem roif_v ist.
    • 9 (hat keinen Wert): Das Formularfeld ist schreibgeschützt, wenn das andere Feld keinen Wert hat.
    roif_cl?: string

    Ein Formularelement kann automatisch deaktiviert werden, basierend auf dem Wert eines anderen Formularelements. Wenn ein Formularfeld deaktiviert ist, kann sein Wert nicht mehr geändert werden. Dies ist ein Flag, das angibt, ob das Formularelement gelöscht wird, wenn es deaktiviert ist. Kann auf eine der folgenden Optionen gesetzt werden:

    • 0 (behalten): Der Wert des Formularelements wird nicht geändert, wenn es deaktiviert ist.
    • 1 (löschen): Der Wert des Formularelements wird gelöscht, wenn es deaktiviert ist. Für Texteingabefelder wird der Wert auf den leeren String gesetzt; für Auswahlfelder werden alle ausgewählten Optionen abgewählt.
    • 2 (zurücksetzen): Der Wert des Formularelements wird auf seinen ursprünglichen Wert zurückgesetzt, wenn es deaktiviert ist.
    roif_v?: string

    Ein Formularelement kann automatisch deaktiviert werden, basierend auf dem Wert eines anderen Formularelements. Wenn ein Formularfeld deaktiviert ist, kann sein Wert nicht mehr geändert werden. Dies ist der Wert, mit dem das andere Formularelement verglichen wird. Ob diese Eigenschaft erforderlich ist und was sie enthalten muss, hängt von der ausgewählten Bedingung ab, siehe roif_c für weitere Details.

    rom?: string

    Ein Formularelement kann automatisch deaktiviert werden, basierend auf dem Wert eines anderen Formularelements. Wenn ein Formularfeld deaktiviert ist, kann sein Wert nicht mehr geändert werden. Wenn diese Eigenschaft auf 1 gesetzt ist, wird der aktuelle Wert des deaktivierten Texteingabefelds verworfen und nicht an den Server übermittelt. Dies entspricht dem HTML-Attribut disabled. Andernfalls, wenn es auf 2 gesetzt ist, wird der Wert an den Server übermittelt. Dies entspricht dem HTML-Attribut readonly.

    Bitte beachten Sie, dass diese Eigenschaft für andere Formularelemente nicht verfügbar ist, da das readonly-HTML-Attribut nur von INPUT-Elementen unterstützt wird.

    ronotif?: string

    Ein Formularelement kann automatisch deaktiviert werden, basierend auf dem Wert eines anderen Formularelements. Wenn ein Formularfeld deaktiviert ist, kann sein Wert nicht mehr geändert werden. Dies ist die ID des anderen (referenzierten) Formularelements. Wenn der Wert dieser Eigenschaft leer ist, wird das Formularelement nicht automatisch deaktiviert.

    Ähnlich wie roif, aber dieses Attribut wird gesetzt, wenn das Formularelement ursprünglich schreibgeschützt ist.

    vcmn?: string

    Die minimale Anzahl von Kontrollkästchen oder Optionsfeldern, die ausgewählt sein müssen. Wenn leer, wird keine Einschränkung angewendet.

    vcmx

    vcmx?: string

    Die maximale Anzahl von Kontrollkästchen oder Optionsfeldern, die ausgewählt sein müssen. Wenn leer, wird keine Einschränkung angewendet.

    vcmn

    vdt?: string

    Der Datentyp wird während der Formularvalidierung verwendet, um sicherzustellen, dass die eingegebenen Daten einem bestimmten Format entsprechen. Die folgenden integrierten Datentypen sind derzeit verfügbar:

    • dateDE: Erlaubt nur deutsche Datumsformate (TT.MM.JJJJ), z.B. 22.05.1990.
    • email: Erlaubt nur gültige (internationale) E-Mail-Adressen, z.B. james@john.org oder θσερ@εχαμπλε.ψομ.
    • integer: Erlaubt nur Ganzzahlen, d.h. Zahlen ohne Dezimalpunkt, z.B. 3, 0 oder -21.
    • ipv4: Erlaubt nur IP4-Adressen, z.B. 127.0.0.1 oder 10.42.42.13.
    • money: Erfordert, dass die Eingabe ein gültiger Geldbetrag ist, d.h. eine Zahl mit genau zwei Dezimalstellen, z.B. 2,00, -3,95, 0,00 oder 897345,38.
    • number: Erlaubt nur Zahlen, einschließlich Zahlen mit Dezimalpunkt, z.B. 0,03, -99,2 oder 42.
    • onlyLetterNumber: Erlaubt nur Buchstaben, Zahlen und Leerzeichen.
    • onlyLetterSp: Erlaubt nur Buchstaben und Leerzeichen.
    • phone: Erlaubt nur gültige Telefonnummern, z.B. 0234995483 oder +49 351 4459654.
    • plzDE: Erlaubt nur Postleitzahlen aus Deutschland, d.h. genau 5 Ziffern, z.B. 02349. Überprüft nicht, ob eine solche Postleitzahl tatsächlich in Deutschland registriert ist.
    • posinteger: Erlaubt nur positive Ganzzahlen, z.B. 0, 3 oder 123.
    • posmoney: Erfordert, dass die Eingabe ein gültiger positiver Geldbetrag ist, der keine negativen Zahlen enthält, z.B. 0,00 oder 2,34.
    • posmoneyOptionalComma: Erfordert, dass die Eingabe ein gültiger positiver Geldbetrag ist, wobei die Dezimalstellen optional sind, z.B. 0,00, 0, 3,4 oder 3.
    • regexp: Erlaubt dem Benutzer, der das Formular erstellt, einen benutzerdefinierten (JavaScript-Flavor) regulären Ausdruck für die Validierung einzugeben.
    • text: Es wird keine Einschränkung angewendet und jede Eingabe ist erlaubt.
    • time: Erfordert, dass die Eingabe eine gültige Uhrzeit im Format hh:mm ist, z.B. 22:05 oder 03:42.
    • url: Erlaubt nur URLs, einschließlich des Protokolls, z.B. http://example.com oder https://www.james.org.
    veq?: string

    Wenn nicht leer, bezieht sich diese Eigenschaft auf die ID eines anderen Formularfelds, das den gleichen Wert wie das Formularfeld haben muss. Das Formularfeld ist ungültig, wenn der Wert des Formularfelds vom Wert des referenzierten Formularfelds abweicht.

    vfex?: string

    Eine durch Kommas getrennte Liste von Dateierweiterungen (ohne das führende Punktzeichen), die eine hochgeladene Datei haben muss, wie z.B. xml,js. Ein Upload-Feld ist ungültig, wenn eine Datei mit einer anderen Dateierweiterung ausgewählt wird. Wenn leer, sind alle Erweiterungen erlaubt.

    vfmx?: string

    Die maximale Dateigröße in Kilobyte, die eine einzelne hochgeladene Datei haben darf. Wenn auf 0 gesetzt, ist die Dateigröße unbegrenzt.

    vgr?: string

    Die erforderliche Gruppe, zu der das Formularfeld gehört. Wenn ein Formularelement Teil einer erforderlichen Gruppe ist, ist das Formular ungültig, wenn kein Element der erforderlichen Gruppe einen Wert hat. Das Formular wird gültig, sobald der Benutzer mindestens ein Formularfeld der erforderlichen Gruppen ausgefüllt hat.

    vmn?: string

    Der minimale numerische Wert (einschließlich), der eingegeben werden muss. Im Gegensatz dazu überprüft vmnl die Anzahl der Zeichen, nicht den numerischen Wert, den diese Zeichen darstellen. Wenn leer, wird keine Einschränkung angewendet.

    vmnl?: string

    Die minimale Anzahl von Zeichen, die in einem Textfeld oder Textbereich eingegeben werden müssen. Bitte beachten Sie, dass diese Einschränkung nur angewendet wird, wenn das Formularfeld nicht leer ist. Wenn also auf 0 gesetzt, ist das Formularfeld niemals ungültig aufgrund dieser Eigenschaft. Um sicherzustellen, dass der Benutzer das Formularfeld nicht leer lässt, verwenden Sie vr.

    vmx?: string

    Der maximale numerische Wert (einschließlich), der eingegeben werden muss. Im Gegensatz dazu überprüft vmxl die Anzahl der Zeichen, nicht den numerischen Wert, den diese Zeichen darstellen. Wenn leer, wird keine Einschränkung angewendet.

    vmn

    vmxl?: string

    Die maximale Länge der zulässigen Eingabe. Wenn auf 0 gesetzt, ist die Länge unbegrenzt. Für Eingabefelder und Textbereiche wird die Länge des eingegebenen Textes überprüft. Für Upload-Felder wird die Länge des Dateinamens überprüft.

    vr?: string

    Wenn auf 0 gesetzt, ist das Formularelement nicht erforderlich und kann leer gelassen werden. Andernfalls, wenn auf 1 gesetzt, ist das Formularelement erforderlich und es muss ein Wert eingegeben werden.

    vrif?: string

    Ein Formularelement kann automatisch zu einem Pflichtfeld gemacht werden, basierend auf dem Wert eines anderen Formularelements. Dies ist die ID des anderen (referenzierten) Formularelements. Wenn der Wert dieser Eigenschaft leer ist, wird das Formularelement nicht automatisch zu einem Pflichtfeld gemacht.

    Ähnlich wie vrnotif, aber dieses Attribut wird gesetzt, wenn das Formularelement ursprünglich optional ist.

    vrif_c?: string

    Ein Formularelement kann automatisch zu einem Pflichtfeld gemacht werden, basierend auf dem Wert eines anderen Formularelements. Dies ist die Bedingung, die auf den Wert des anderen Formularelements angewendet wird. Verfügbare Bedingungstypen sind:

    • 0 (hat einen Wert): Das Formularfeld ist ein Pflichtfeld, wenn das andere Feld nicht leer ist.
    • 1 (gleich): Das Formularfeld ist ein Pflichtfeld, wenn der Wert des anderen Feldes dem vrif_v entspricht.
    • 2 (ungleich): Das Formularfeld ist ein Pflichtfeld, wenn der Wert des anderen Feldes nicht dem vrif_v entspricht.
    • 3 (entspricht regulärem Ausdruck): Das Formularfeld ist ein Pflichtfeld, wenn das andere Feld dem im vrif_v enthaltenen regulären Ausdruck entspricht.
    • 4 (ist kleiner als): Das Formularfeld ist ein Pflichtfeld, wenn der Wert des anderen Feldes kleiner ist als der vrif_v.
    • 5 (ist größer als): Das Formularfeld ist ein Pflichtfeld, wenn der Wert des anderen Feldes größer ist als der vrif_v.
    • 6 (liegt zwischen): Das Formularfeld ist ein Pflichtfeld, wenn der Wert des anderen Feldes im Bereich liegt, der durch vrif_v angegeben ist. Das vrif_v muss ein Bereich im Format x-y sein, z.B. 2-37.
    • 7 (ist kleiner oder gleich): Das Formularfeld ist ein Pflichtfeld, wenn der Wert des anderen Feldes kleiner oder gleich dem vrif_v ist.
    • 8 (ist größer oder gleich): Das Formularfeld ist ein Pflichtfeld, wenn der Wert des anderen Feldes größer oder gleich dem vrif_v ist.
    • 9 (hat keinen Wert): Das Formularfeld ist ein Pflichtfeld, wenn das andere Feld keinen Wert hat.
    vrif_v?: string

    Ein Formularelement kann automatisch zu einem Pflichtfeld gemacht werden, basierend auf dem Wert eines anderen Formularelements. Dies ist der Wert, mit dem das andere Formularelement verglichen wird. Ob diese Eigenschaft erforderlich ist und was sie enthalten muss, hängt von der ausgewählten Bedingung ab, siehe vrif_c für weitere Details.

    vrmm?: string

    Diese Nachricht wird dem Benutzer angezeigt, wenn der Wert eines Formularfelds nicht mit dem vrule regulären Ausdruck übereinstimmt. Wenn nicht gesetzt, wird eine generische Fehlermeldung angezeigt.

    vrnotif?: string

    Ein Formularelement kann automatisch zu einem Pflichtfeld gemacht werden, basierend auf dem Wert eines anderen Formularelements. Dies ist die ID des anderen (referenzierten) Formularelements. Wenn der Wert dieser Eigenschaft leer ist, wird das Formularelement nicht automatisch zu einem Pflichtfeld gemacht.

    Ähnlich wie vrif, aber dieses Attribut wird gesetzt, wenn das Formularelement ursprünglich erforderlich ist.

    vrule?: string

    Dies ist der reguläre Ausdruck, der zur Validierung des Formularfelds verwendet wird. Dies muss ein gültiger JavaScript regulärer Ausdruck sein. In der Regel wird empfohlen, die Anker ^...$ zu verwenden, um sicherzustellen, dass die gesamte Eingabe dem Muster entspricht.