KB form
Aus Kitbooth Wiki: Deutsch
Inhaltsverzeichnis[Verbergen] |
Beschreibung
Die Klasse KB_form unterstützt den Webdesigner und Entwickler beim Erstellen und Auswerten von Formularen. Zusätzliche Funktionen wie ein E-Mail-Versand oder eine Registrierung werden bei der Auswertung der übersendeten Daten unterstützt.
Verwendung
KB_form wird für jedes Formular einmal instanziert. Die Core-Funktionalität stellt dafür die Funktion $kbc->form_o() im globalen Kontext zur Verfügung.
$form = $kbc->form_o();
new_element()
Jedes Formular-Element wird einzeln definiert. Dazu wird die Methode new_element aufgerufen und der Name des Elements übergeben. Danach kann das Element über $form->element[' Name '] angesprochen werden.
$form->new_element("Name");
Das neu definierte Element besitzt bereits alle wichtigen Eigenschaften. So ist der z. B. Formulartyp ein Input-Feld. Vorgegebene Eigenschaften können überschrieben werden.
Eigenschaften
type
Type legt den Formulartyp fest. Mögliche Werte sind:
| Eigenschaft | Beschreibung | HTML-Entsprechung |
|---|---|---|
| input | Texteingabefeld | <input type="text"> |
| password | Passworteingabefeld | <input type="password"> |
| radio | Einfachauswahl | <input type="radio"> |
| select | Mehrfachauswahl | <input type="checkbox"> |
| dropdown | Dropdown-Menü | <select> |
$form->element['Name']['type'] = 'dropdown';
value
Mit value lassen sich die Werte von Formularelemente vorbelegen. Bei den Formularelmente, die eine Auswahl an Werten ermöglichen (wie Dropdown-Menü), ist zu dem die Festlegung der möglichen Werte über value pflicht.
Für Elemente mit den Typ input oder password wird der Wert einfach als String übergeben.
$form->element['Name']['value'] = 'Wert' ;
Für Elemente mit den Typ radio, select oder dropdown wird der Wert als Array übergeben.
$form->element['Name']['value'] = array( 'Wert' ,Array);
