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"> |
| hidden | Verstecktes Textfeld | <input type="hidden"> |
| textarea | Mehrzeiliges Textfeld | <textarea> |
| radio | Einfachauswahl | <input type="radio"> |
| select | Mehrfachauswahl | <select> |
| checkbox | Mehrfachauswahl zum Ankreuzen | <input type="checkbox"> |
| dropdown | Dropdown-Menü | <select> |
| button | Schaltfläche | <button> |
| submit | Schaltfläche zum Absenden | <button type="submit"> |
$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.
Der Standardwert für value ist leer.
Für Elemente mit den Typ input, password, hidden, textarea , button oder submit wird der Wert einfach als String übergeben.
$form->element['Name']['value'] = 'Wert' ;
Für Elemente mit den Typ radio, select, checkbox oder dropdown wird der Wert als Array übergeben.
$form->element['Name']['value'] = array( 'Wert',$array);
Der zweite Wert im Array, beinhaltet die möglichen Werte, die das Formular-Element haben kann, ebenfalls als Array. Die Vorbelegung und der versendete Wert werden mit den Keys (nicht den Values) des Arrays durchgeführt.
$array = array( 'name1' => 'Erster Name', 'name2' => 'Zweiter Name' );
Soll Erster Name vorbelegt werden, muss name1 übergeben werden.
$form->element['Name']['value'] = array( 'name1',$array);
Soll kein Wert vorbelegt werden, muss NULL übergeben werden.
$form->element['Name']['value'] = array( NULL,$array);
essential
Der Standardwert für essential ist false.
label
Der Standardwert für label ist leer.
description
Der Standardwert für description ist leer.
message
Der Standardwert für message ist Dieses Feld muss ausgefüllt sein.
markup
Der Standardwert für markup ist leer.
