Wird für die Erstellung von HTML Button Elementen verwendet wobei Zend_Form_Element_Button Zend_Form_Element_Submit erweitert, und seine eigene Funktionalität hinzufügt. Sie spezifiziert den 'formButton' View Helfer für die Dekoration.

Wie das Submit Element, verwendet es das Label des Elements als den Elementwert für Darstellungszwecke; in anderen Worten, um den Text des Buttons zu setzen, muß der Wert des Elements gesetzt werden. Das Label wird übersetzt wenn ein Übersetzungsadapter vorhanden ist.

Weil das Label als Teil des Elements verwendet wird, verwendet das Button Element nur den ViewHelper und den DtDdWrapper Dekorator.

Nach der Veröffentlichung oder Prüfung einer Form, kann geprüft werden ob der gegebene Button geklickt wurd indem die isChecked() Methode verwendet wird.

HTML Checkboxen erlauben es spezifische Werte zurückzugeben, arbeiten aber grundsätzlich als Boolean: Wenn Sie angehackt sind, wird der Wert übertragen; wenn Sie nicht angehackt sind, wird nichts übertragen. Intern erzwingt Zend_Form_Element_Checkbox diesen Status.

Standardmäßg ist der angehackte Wert '1', und der nicht angehackte Wert '0'. Dieser Wert kann spezifiziert werden indem die setCheckedValue() und setUncheckedValue() Zugriffsmethoden verwendet werden. Intern wird, jedesmal wenn der Wert gesetzt wird, wenn der angebotene Wert dem angehackten Wert entspricht, er gesetzt, aber jeder andere Wert bewirkt das der nicht angehackte Wert gesetzt wird.

Zusätzlich setzt, das Setzen des Werte, die checked Eigenschaft der Checkbox. Das kann abgefragt werden indem isChecked() verwendet wird oder einfach auf die Eigenschaft zugegriffen wird. Das Verwenden der setChecked($flag) Methode setzt beides, den Status des Flags sowie den entsprechenden gecheckten oder nicht gecheckten Wert im Element. Bitte verwenden Sie diese Methode wenn der gecheckte Status eines Checkbox Elements gesetzt wird um sicherzustellen das der Wert richtig gesetzt wird.

Zend_Form_Element_Checkbox verwendet den 'formCheckbox' View Helfer. Der angehackte Wert wird immer verwendet um Sie zu veröffentlichen.

Versteckte Elemente fügen Daten ein die übertragen werden sollen, aber welche der Benutzer nicht manipulieren soll. Zend_Form_Element_Hidden ermöglicht das durch die Verwendung des 'formHidden' View Helfers.

Dieses Element bietet Schutz vor CSRF Attacken auf Forms, und stellt sicher das die Daten die übertragen werden von der Benutzersession stammen die die Form erstellt hat und nicht durch ein bösartiges Skript. Sicherheit wird ermöglicht durch das hinzufügen eines Hash Elements zur form und dessen Prüfung wenn die Form übermittelt wird.

Der Name des Hash Elements sollte einmalig sein. Es ist notwendig das die salt Option für das Element verwendet wird, damit zwei Hashes mit dem gleichen Namen und unterschiedlichen Salts nicht kollidieren:

<?php
$form->addElement('hash', 'no_csrf_foo', array('salt' => 'unique'));
?>

Das Salt kann später gesetzt werden durch Verwendung der setSalt($salt) Methode.

Intern speichert das Element einen eindeutigen Identifikator indem es Zend_Session_Namespace verwendet, und danach bei der Übertragung checkt (es wird geprüft das die TTL nicht abgelaufen ist). Die 'Identical' Prüfung wird Internally, the element stores a unique identifier using Zend_Session_Namespace, and checks for it at submission (checking that the TTL has not expired). The 'Identical' validator is then used to ensure the submitted hash matches the stored hash.

Der 'formHidden' View Helfer wird verwendet um das Element in der Form darzustellen.

Bilder können als Form Elemente verwendet werden und erlaubt es graphische Elemente als Form Buttons zu spezifizieren.

Bilder benötigen eine Bildquelle. Zend_Form_Element_Image erlaube dessen Spezifikation durch Verwendung der setImage() Zugriffsmethode (oder des 'image' Konfigurations Schlüssels). Es kann auch optional ein Wert spezifiziert werden der zu verwenden ist wenn das Bild übertragen wird indem die Zugriffsmethode setImageValue() verwendet wird (oder der 'imageValue Konfigurations Schlüssel). Wenn der Wert der für das Element gesetzt ist, mit imageValue übereinstimmt, gibt isChecked() true zurück.

Das Bild Element verwenden den Image Decorator für die Darstellung (genauso wie die Standard Error, HtmlTag und Label Dekoratore). Es kann optional ein Tag für den Image Dekorator spezifiziert werden der das Bild einbettet.

Oft hat man ein Set von zusammenhängenden Checkboxen, und die Ergebnisse sollen gruppiert werden. Das ist so ähnlich wie Multiselect aber statt das Sie in einer DropDown Liste sind, müssen Checkbox/Werte Paare dargestellt werden.

Zend_Form_Element_MultiCheckbox macht das in einem Rutsch. Wie alle anderen Elemente kann mit der Erweiterung des Basis MultiElements eine Liste von Optionen spezifiziert werden und einfach gegen die selbe Liste geprüft werden. Der 'formMultiCheckbox' View Helfer stellt sicher das Sie als Array bei der Übermittlung der Form zurückgegeben werden.

Die verschiedenen Checkbox Optionen können mit den folgenden Methoden manipuliert werden:

• addMultiOption($option, $value)

• addMultiOptions(array $options)

• setMultiOptions(array $options) (überschreibt existierende Optionen)

• getMultiOption($option)

• getMultiOptions()

• removeMultiOption($option)

• clearMultiOptions()

XHTML select Elemente erlaube ein 'multiple' Attribut, das zeigt das mehrere Optionen für die Übermittlung ausgewählt werden können, statt normalerweise nur eines. Zend_Form_Element_Multiselect erweitert Zend_Form_Element_Select und setzt das multiple Attribut auf 'multiple'. Wie andere Klassen die von der Basisklasse Zend_Form_Element_Multi abgeleitet werden, können die Optionen für die Auswahl wie folgt verändert werden:

• addMultiOption($option, $value)

• addMultiOptions(array $options)

• setMultiOptions(array $options) (überschreibt existierende Optionen)

• getMultiOption($option)

• getMultiOptions()

• removeMultiOption($option)

• clearMultiOptions()

Wenn ein Übersetzungs Adapter in der Form und/oder dem Element registriert ist, werden Optionswerte für Darstellungzwecke übersetzt.

Passwort Element sind grundsätzlich normale Textelemente -- ausser das typischerweise das eingegebene Passwort nicht in Fehlermeldungen oder dem Element selbst angezeigt werden soll wenn die Form normals angezeigt wird.

Zend_Form_Element_Password ermöglicht das durch den Aufruf von setObscureValue(true) auf jeder Prüfung (und stellt sicher das das Passwort in der Prüfungs Fehlermeldung verschleiert wird), und verwendet den 'formPassword' View Helfer (welcher den an Ihn übergebenen Wert nicht anzeigt).

Radio Elemente erlauben es verschiedene Optionen zu spezifizieren, von denen ein einzelner Wert zurückgegeben wird. Zend_Form_Element_Radio erweitert die Basisklasse Zend_Form_Element_Multi und erlaubt es eine Anzahl von Optionen zu spezifizieren, und verwendet dann den formRadio View Helfer um diese darzustellen.

Wie alle Elemente die die Basisklasse des Mutli Elements erweitern, können die folgenden Methode verwendet werden um die Radio Optionen zu manipulieren die angezeigt werden:

• addMultiOption($option, $value)

• addMultiOptions(array $options)

• setMultiOptions(array $options) (überschreibt existierende Optionen)

• getMultiOption($option)

• getMultiOptions()

• removeMultiOption($option)

• clearMultiOptions()

Reset Buttons werden typischerweise verwendet um eine Form zu löschen, und sind nicht Teil der übermittelten Daten. Da Sie trotzdem einen Zweck in der Anzeige bieten, sind Sie in den Standardelementen enthalten.

Zend_Form_Element_Reset erweitert Zend_Form_Element_Submit. Deswegen wird das Label für die Anzeige des Buttons verwendet und wird übersetzt wenn ein Übersetzungs Adapter vorhanden ist. Es verwendet nur die 'ViewHelper' und 'DtDdWrapper' Dekoratore, da es nie Fehlermeldungen für solche Elemente geben sollte, noch sollte ein Label notwendig sein.

Auswahlboxen sind der übliche Weg um spezielle Auswahlen für gegebene Formdaten zu begrenzen. Zend_Form_Element_Select erlaubt es diese schnell und einfach zu erzeugen.

Da es das Basis Multielement erweitert, können die folgenden Methoden verwendet werden um die Auswahloptionen zu manipulieren:

• addMultiOption($option, $value)

• addMultiOptions(array $options)

• setMultiOptions(array $options) (überschreibt existierende Optionen)

• getMultiOption($option)

• getMultiOptions()

• removeMultiOption($option)

• clearMultiOptions()

Zend_Form_Element_Select verwendet den 'formSelect' View Helfer für die Dekoration.

Sendebuttons (Submit) werden verwendet um eine Form zu senden. Es kann gewünscht sein mehrere Sendebuttons zu verwendetn; die Buttons zur Übermittlung der Form können verwendet werden um auszuwählen welche Aktion mit den übermittelten Daten genommen werden soll. Zend_Form_Element_Submit macht die Entscheidung einfach, durch das Hinzufügen einer isChecked() Methode; da nur ein Button Element von der Form übermittelt wird, nachdem die Form übermittelt oder geprüft wurde, kann diese Methode auf jedem Sendebutton ausgerufen werden um festzustellen welcher verwendet wurde.

Zend_Form_Element_Submit verwendet das Label als den "Wert" des Sendebuttons, und übersetzt es wenn ein Übersetzungsadapter vorhanden ist. isChecked() prüft den übermittelten Wert gegen das Label um festzustellen ob der Button verwendet wurde.

Die ViewHelper und DtDdWrapper Dekoratore werden verwendet um das Element darzustellen. Es wird kein Labeldekorator verwendet, da das Label des Buttons verwendet wird wenn das Element dargestellt wird; typischerweise werden acuh keine Fehler mit einem Sendeelement assoziiert.

Der nützlichste Typ von Form Element ist das Text Element, das begrenzte Texteinträge erlaubt; es ist ein ideales Element für die meisten Dateneinträge. Zend_Form_Element_Text verwendet einfach den 'formText' View Helfer um das Element darzustellen.

Textbereiche werden verwendet wenn große Mengen von Text erwartet werden, und keine Begrenzung in der Anzahl des übermittelten Textes vorhanden sind (anders als das Limit der Maximalgröße wie vom Server von PHP diktiert). Zend_Form_Element_Textarea verwendet den 'textArea' View Helfer um solche Element darzustellen, und platziert den Wert als Inhalt des Elements.