JQuery Kochbuch (German Edition)

hinzugefügt werden und abgesehen von der Remote-Validierung gibt es keine Notwendigkeit, die Anwendung irgendwie anzupassen. Das ist für einfache Kommentar-Forms für ein Blog nützlich, genauso aber auch für komplexere Forms einer Intranet-Anwendung oder für alles dazwischen.
    Die wichtigsten Elemente des Plugins sind Regeln und Methoden. Methoden enthalten Validierungs-Logik, so wie die E-Mail-Methode, die einen regulären Ausdruck nutzt, um zu bestimmen, ob es sich bei einem Wert um eine gültige E-Mail-Adresse handelt. Regeln verbinden Eingabefelder mit Methoden, wobei eine einzelne Regel aus der Kombination eines Eingabefeldes und einer Methode besteht. Das E-Mail-Feld weist also eine Regel auf, die es zu einem Pflichtfeld macht, und eine, die festlegt, dass eine E-Mail-Adresse als Eingabe erwartet wird.
    Methoden
    Das Plugin besitzt etwa 19 eingebaute Methoden. Die grundlegende Methode ist
required
– wenn diese angegeben ist, muss das Feld ausgefüllt werden. Lässt man sie weg, dann werden die meisten anderen Methoden bei einem leeren Feld ignoriert. Die einzige Ausnahme bildet die Methode
equalTo
, die prüft, ob der Inhalt eines Feldes genau dem eines anderen Feldes entspricht. Dies wird auch für ein leeres Feld geprüft. Die Regel selbst wird meist für Felder genutzt, in denen Passwörter bestätigt werden müssen.
    Die Methoden
email
,
url
,
date
,
dateISO
,
dateDE
,
number
,
numberDE
,
digits
und
creditcard
prüfen den Wert alle anhand bestimmter Datentypen mit kleinen Unterschieden für verschiedene Locales. So muss man zum Beispiel bei
number
eine Zahl im US-Format wie 1,000.00 eingeben, während
numberDE
das deutsche Format 1.000,00 erfordert.
    Die Methoden
min
und
max
sowie
range
prüfen den Wert einer Zahl, während
minlength
,
maxlength
und
rangelength
die Anzahl der Zeichen kontrollieren.
    Bei einem Auswahlfeld oder bei Checkboxen prüfen
min
,
max
und
range
die Anzahl der ausgewählten Optionen oder markierten Checkboxen.
    Bei Dateifeldern ist die Methode
accept
praktisch – sie prüft die Dateierweiterung, wobei sie standardmäßig nach
.gif
,
.png
,
.jpg
oder
.jpeg
schaut.
    Die Methode
remote
ist die einzige Methode, die die Validierungslogik auf den Server verlagert. Sie erhält eine URL als Parameter, die auf eine Ressource auf dem Server zeigt. Das kann ein Skript sein, das eine Datenbankabfrage durchführt, um zum Beispiel zu prüfen, ob ein Benutzername schon vorhanden ist oder ob eine E-Mail-Adresse schon registriert ist. Ein Besipiel für eine Registrierungsform, das die Remote-Methode für den Benutzernamen und die E-Mail-Adresse nutzt, finden Sie unter http://jquery-cookbook.com/go/plugin-validation-remote-demo .
    Eigene Methoden
    Sie können das Plugin durch eigene Methoden erweitern, um anwendungsspezifische Anforderungen umzusetzen. Vielleicht haben Sie eine Form, in der die Benutzer URLs eingeben, die mit einer bestimmten Firmen-Domain beginnen müssen. Eine eigene Methode kann die notwendige Überprüfung vornehmen:
jQuery.validator. addMethod ("domain", function(value, element) {
    return this.optional(element) || /^http:\/\/mycorporatedomain.com/.test(value);
}, "Bitte geben Sie die korrekte Domain für Ihre Dokumente an");
    Das erste Argument von
jQuery.validator.addMethod
ist der Name der eigenen Methode. Dabei muss es sich um eine gültige JavaScript-Kennung handeln. Das zweite Argument ist eine Funktion, die die Überprüfung vornimmt. Gibt sie true zurück, dann ist die Eingabe gültig. Dabei wird
this.optional(element)
genutzt, um herauszufinden, ob das Eingabefeld keinen Wert enthält und daher übersprungen werden sollte – alle Standardmethoden nutzen hier den gleichen Aufruf. Das dritte Argument legt die Standard-Meldung für die neue Methode fest.
    Wenn man eine Methode schreiben möchte, die einen Parameter erwartet, funktioniert das sehr ähnlich:
jQuery.validator. addMethod ("math", function(value, element, params) {
    return this.optional(element) || value == params[0] + params[1];
}, jQuery.format("Bitte geben Sie korrekte Werte für {0} + {1} ein"));
    In diesem Fall wird die Standard-Mitteilung mit Hilfe von
jQuery.format
definiert, eine Hilfsfunktion, die das Plugin bereitstellt. Die in geschweiften Klammern angegebenen Index-Platzhalter werden bei der Überprüfung durch die eigentlichen Parameter ersetzt.
    Eigene Methoden können auch auf bestehende Methoden zurückgreifen, wenn man zum Beispiel andere Standard-Meldungen für eine bestimmte Methode