KB form
Aus Kitbooth Wiki: Deutsch
Admin (Diskussion | Beiträge) (→Eigenschaften) |
Admin (Diskussion | Beiträge) K (→message) |
||
Zeile 77: | Zeile 77: | ||
==== message ==== | ==== message ==== | ||
- | Der Standardwert für '''message ''' ist ''Dieses Feld muss ausgefüllt sein.'' | + | Der Standardwert für '''message ''' ist ''Dieses Feld muss ausgefüllt sein.'' |
==== markup ==== | ==== markup ==== |
Version vom 18. März 2012, 09:33 Uhr
Inhaltsverzeichnis |
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);
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.