direkt zum Inhalt springen zur Schnellnavigation zur Navigationshilfe

<we:checkForm></we:checkForm>

ab Version: 3.2.0.0 | Endtag erforderlich: ja

Beschreibung

Das Tag we:checkForm führt eine Validierung eines Formulars per JavaScript durch. Die Kombination der Parameter 'match' und 'type' legen den 'name',bzw. die 'id' des zu kontrollierenden Formulars fest. 'mandatory' und 'email' erwarten eine kommaseparierte Liste von Pflichtfeldern, bzw. Email-Adressen(Syntax-Check). In 'password' können kommasepariert 2 Feldnamen und eine Mindestlänge eingegeben werden, die auf Gleichheit, bzw. die Mindestlänge überprüft weden. Mit onError kann im Fehlerfall eine eigene JavaScript-Funktion aufgerufen werden, die als Parameter arrays mit fehlenden Pflichtfeldern und den invaliden Email-Adressen erhält, als dritter Parameter wird ein Flag übergeben, ob die Passworteingabe korrekt war. Andernfalls wird der Standardwert im Fehlerfall ausgegeben.

Attribute

  • match

    Typ: string | Standardwert: - | Pflichtfeld: ja

    Bei diesem Attribut geben Sie den "name" oder die "id" des zu überprüfenden Formulars an.
  • type

    Typ: string | mögliche Werte: id, name | Standardwert: - | Pflichtfeld: ja

    Bei diesem Attribut geben Sie an, ob das Attribut "match" die "id" oder den "name" des Formulars referenziert.
  • mandatory

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Hier geben sie eine kommaseparierte Liste der Pflichtfelder des Formulars an.
  • email

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Hier geben sie eine kommaseparierte Liste der E-Mailfelder des Formulars an. Diese werden dann auf korrekte Syntax kontrolliert.
  • password

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Das password-Attribut erfordert die Eingabe von zwei Passwortfeldern und einer Mindestlänge des Passworts. Die Passwörter werden auf Übereinstimmung kontrolliert und in Hinblick auf die erforderlichen Mindestlänge.
  • onError

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Mit dem Attribut "onError" können Sie eine eigene Javascript-Funktion benutzen, die im Fehlerfall aufgerufen wird. Diese erhält einen Verweis auf das Formular, einen Array mit Namen der fehlenden Pflichtfelder, einen Array mit Namen der syntaktisch nicht korrekten E-Mail Felder, sowie ein Flag, ob die Passworteingabe fehlerhaft war, als Parameter übergeben.

  • jsIncludePath

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Für diesen webEdition-Tag wird eine Javascript-Datei eingebunden, die sich innerhalb des webEdition-Verzeichnis befindet ("/webEdition/js/external/weCheckForm.js"). Sollte Ihr webEdition Verzeichnis passwortgeschützt sein, können Sie diese Datei in ein ungeschütztes Verzeichnis Ihres Web-Servers kopieren und den ungeschützten Pfad durch das Attribut "jsIncludePath" einstellen.

  • cachelifetime

    Typ: number | Standardwert: 0 | Pflichtfeld: nein

    Mit diesem Attribut definieren Sie die Gültigkeit des Caches in Sekunden für diesen we-Tag. Dieses Attribut wird nur verwendet, wenn in der Vorlage "we-Tag-Cache" bzw. "kein Cache" eingestellt ist.

Syntax

<we:checkForm match="" type="id|name" mandatory="" email="" password="" onError="" jsIncludePath="" cachelifetime="">
...
</we:checkForm>

Beispiele

Beispiel #1

Code 
<we:checkForm match="newsletter" type="id" mandatory="name,address,zip,city,we_subscribe_email__," email="we_subscribe_email__" onError="dealFormError">Please check the form</we:checkForm>

Beispiel #2

Wenn Sie beispielsweise eine Fehlerfunktion namens "errorHandler" einsetzen wollen, sollten Sie folgenden Code benutzen.

Erklärung der Parameter: form: Verweis auf das Javascript Formular Objekt missingReq: Array, der die Namen aller nicht ausgefüllten Pflichtfelder enthält wrongEmails: Array, der die Namen aller nicht syntaktisch nicht korrekten E-Mail Adressen enthält passwordError: true, wenn ein Fehler bei der Passworteingabe vorliegt (nicht gleich oder zu kurz). Code 
<we:checkForm .. onError="errorHandler" .. >

        <script type="text/javascript">
        function errorHandler (form,missingReq,wrongEmails,passwordError) {
         
        }
        </script>

Bitte helfen Sie mit

Haben Sie eine Ergänzung für die Tag-Referenz, dann werden Sie bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder einfach formlos per E-Mail an websites@webedition.org.

Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.
zum Seitenanfang