PEAR-Handbuch | ||
---|---|---|
Zurück | Kapitel 42. HTML | Nach vorne |
Das PEAR::HTML_QuickForm-Package bietet Methoden zur Erzeugung, Überprüfung und Verarbeitung von HTML-Formular.
QuickForm ist eine umfangreiche Bibliothek zum Umgang mit HTML-Formularen. Es bietet die Validierung von Eingaben auf Client-Seite (über JavaScript) und Server-Seite und ist auf viele Arten anpass- und erweiterbar. QuickForm umfasst viele Dateien. Die Hauptdatei ist QuickForm.php und sollte sich im Verzeichnis pear/HTML befinden. Weitere wichtige Dateien sind element.php, die alle relevanten Methoden für Formularelemente enthält, und group.php, welche Methoden enthält, die sich auf Gruppen von Elementen beziehen. Beide befinden sich im Verzeichnis HTML/QuickForm mit den anderen Formularobjekten. Die Datei input.php enthält eine allgemeine Klasse für alle Eingabeelemente (Text, Password ...). QuickForm besitzt Objekte alle üblichen Formularelemente: Select, Text, Password, Checkbox, File, Submit, Reset, Button, Image, Radio, Hidden, Textarea. QuickForm ermöglicht die Erzeugung eigener Elemente, solange sie übereinstimmen mit dem allgemeinen Befehlssatz.
Dieser Abschnitt beschreibt die Methoden zum Umgang mit den Werten von Elementen und der erhaltenen Werte.
QuickForm unterstützt Regeln zur Überprüfung von Werten. Sie können eigene Validierungsregeln anlegen, sie in QuickForm registrieren und in Ihren Skripten aufrufen. Standardmäßig beherrscht QuickForm die Überprüfung über reguläre Ausdrücke (preg_match-Stil) und die Prüfung auf erforderliche Elemente. Wenn eine client-seitige Validierung notwendig ist, dann wird der entsprechende JavaScript-Code ebenfalls generiert. Die server-seitige Validierung ist automatisch aktiv.
QuickForm kann auch Filter für den Datenübertragung zum Formular benutzen oder zur Verarbeitung übertragener Formulardaten. Filter funktionieren genauso wie Regeln, müssen aber nicht in QuickForm registriert werden. Sie können Ihre eigenen Filter-Funktionen schreiben und sie in einem Skript aufrufen. Jede PHP-Funktion, wie z.B. trim, addslashes, htmlentities, etc., kann benutzt und nacheinander auf die Werte der Elemente angewendet werden.
Sie können das Formular auf vielfältige Arten anpassen. QuickForm kann verschiedene Arten von Renderen benutzen, der standardmäßige, der die Anpassung des Formulars, seiner Elemente, der Fehlermeldungen, der Überschriften und der Hinweistexte und Markierungen für erforderlichen Elemente. Sie können auch ihren eigenen Render einsetzen.
Diese Renderer basieren auf dem Code für HTML_QuickForm-Version kleiner 3 und benötigen keine zusätzlichen Klassen zum funktionieren.
Diese Renderer benutzen Templates, um das HTML für das Formular zu erzeugen.
Wenn Sie die existierenden Renderer modifizieren wollen oder einen neuen schreiben wollen, dann ist dieser Abschnitt für Sie relevant.
Zurück | Zum Anfang | Nach vorne |
Output | Nach oben | HTML_QuickForm_Controller |