documentation/manual/de/module_specs/Zend_Form-Forms.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21825 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="zend.form.forms">
   5     <title>Erstellen von Form durch Verwendung von Zend_Form</title>
   6
   7     <para>
   8         Die <classname>Zend_Form</classname> Klasse wird verwendet um Form Element, Anzeigegruppen
   9         und Unterforms zu gruppieren. Sie kann die folgenden Aktionen an diesen Elementen vornehmen:
  10     </para>
  11
  12     <itemizedlist>
  13         <listitem>
  14             <para>Prüfung, inklusive dem Empfang von Fehlercodes und Meldungen</para>
  15         </listitem>
  16
  17         <listitem>
  18             <para>
  19                 Werte behandeln, inklusive der Übermittlung von Elementen und dem Empfangen von
  20                 beiden, gefilterten und ungefilterten Werten, von allen Elementen
  21             </para>
  22         </listitem>
  23
  24         <listitem>
  25             <para>
  26                 Iteration über alle Elemente in der Reihenfolge in der Sie eingegeben wurden oder
  27                 basierend auf der Reihenfolge in der Hinweise von jedem Element empfangen werden
  28             </para>
  29         </listitem>
  30
  31         <listitem>
  32             <para>
  33                 Darstellung der kompletten Form, antweder über einen eigenen Dekorator der eigene
  34                 Darstellungen durchführt oder durch die Iterierung über jedes Element in der Form
  35             </para>
  36         </listitem>
  37     </itemizedlist>
  38
  39     <para>
  40         Wärend Formen die mit <classname>Zend_Form</classname> erstellt werden komplex sein können,
  41         ist der warscheinlich beste Verwendungzweck eine einfache Form; die beste Verwendung ist für
  42         Rapid Application Development (RAD) und Prototyping.
  43     </para>
  44
  45     <para>
  46         In der einfachsten Art, wird einfach ein Form Objekt instanziert:
  47     </para>
  48
  49     <programlisting language="php"><![CDATA[
  50 // Generelles Form Objekt:
  51 $form = new Zend_Form();
  52
  53 // Eigenes Form Objekt:
  54 $form = new My_Form()
  55 ]]></programlisting>
  56
  57     <para>
  58         Es kann optional eine Instanz von <classname>Zend_Config</classname> oder ein Array
  59         übergeben werden, welches verwendet wird um den Status des Objektes zu setzen sowie
  60         potentiell neue Elemente zu erstellen:
  61     </para>
  62
  63     <programlisting language="php"><![CDATA[
  64 // Konfigurations Optionen übergeben:
  65 $form = new Zend_Form($config);
  66 ]]></programlisting>
  67
  68     <para>
  69         <classname>Zend_Form</classname> ist iterierbar und iteriert durch die Elemente,
  70         Anzeigegruppen und Subforms, indem es die Reihenfolge in der diese registriert wurde
  71         verwendet und jede Reihenfolge die der Index hat. Das ist nützlich in den Fällen in denen
  72         Elemente manuell in einer bestimmten Reihenfolge dargestellt werden sollen.
  73     </para>
  74
  75     <para>
  76         <classname>Zend_Form</classname>'s Magie liegt in der Fähigkeit als Factory für Elemente und
  77         Anzeigegruppen zu arbeiten, genauso wie die Fähigkeit sich selbst durch Dekoratore
  78         darzustellen.
  79     </para>
  80
  81     <sect2 id="zend.form.forms.plugins">
  82         <title>Plugin Loader</title>
  83
  84         <para>
  85             <classname>Zend_Form</classname> verwendet
  86             <classname>Zend_Loader_PluginLoader</classname> um es Entwicklern zu erlauben Orte von
  87             alternativen Elementen und Dekoratoren zu spezifizieren. Jeder hat seinen eigenen mit
  88             Ihm assoziierten Plugin Loader, und generelle Zugriffspunkte werden verwendet um jeden
  89             zu empfangen und zu ändern.
  90         </para>
  91
  92         <para>
  93             Die folgenden Loadertypen werden mit den verschiedenen Plugin Loader Methoden
  94             verwendet: 'element' und 'decorator'. Die Typnamen sind unabhängig von der
  95             Schreibweise.
  96         </para>
  97
  98         <para>
  99             Die Methoden um mit Plugin Loader zu interagieren sind die folgenden:
 100         </para>
 101
 102         <itemizedlist>
 103             <listitem>
 104                 <para>
 105                     <methodname>setPluginLoader($loader, $type)</methodname>: $loader ist das Plugin
 106                     Loader Objekt selbst. Das setzt den Plugin Loader für den gegebenen Typ zu dem
 107                     neu spezifizierten Loader Objekt.
 108                 </para>
 109             </listitem>
 110
 111             <listitem>
 112                 <para>
 113                     <methodname>getPluginLoader($type)</methodname>: Empfängt den mit $type
 114                     assoziierten Plugin Loader.
 115                 </para>
 116             </listitem>
 117
 118             <listitem>
 119                 <para>
 120                     <methodname>addPrefixPath($prefix, $path, $type = null)</methodname>: Fügt eine
 121                     Präfix/Pfad Assoziation zum durch $type spezifizierten Loader hinzu. Wenn $type
 122                     <constant>NULL</constant> ist, versucht es den Pfad allen Loadern hinzuzufügen,
 123                     durch anhängen des Präfix an jedes "_Element" und "_Decorator"; und anhängen des
 124                     Pfades an "Element/" und "Decorator/". Wenn man alle Extra Form Elementklassen
 125                     in einer normalen Hierarchie sind, ist das die übliche Methode für das Setzen
 126                     eines Basispräfix für Sie.
 127                 </para>
 128             </listitem>
 129
 130             <listitem>
 131                 <para>
 132                     <methodname>addPrefixPaths(array $spec)</methodname>: Erlaubt es viele Pfade auf
 133                     einmal zu einem oder mehreren Plugin Loadern hinzuzufügen. Sie erwartet das
 134                     jedes Array Element ein Array mit den Schlüsseln 'path', 'prefix' und 'type'
 135                     ist.
 136                 </para>
 137             </listitem>
 138         </itemizedlist>
 139
 140         <para>
 141             Zusätzlich kann ein Präfixpfad für alle Elemente und Anzeigegruppen die durch eine
 142             <classname>Zend_Form</classname> Instanz erstellt wurden, spezifiziert werden, durch
 143             Verwendung der folgenden Methoden:
 144         </para>
 145
 146         <itemizedlist>
 147             <listitem>
 148                 <para>
 149                     <methodname>addElementPrefixPath($prefix, $path, $type = null)</methodname>: Wie
 150                     <methodname>addPrefixPath()</methodname>, nur das ein Klassenpräfix und ein Pfad
 151                     spezifiziert werden muß. Wenn <varname>$type</varname> spezifiziert wurde, muß
 152                     er einer der Plugin Loader Typen sein die in
 153                     <classname>Zend_Form_Element</classname> spezifiziert sind; siehe das <link
 154                         linkend="zend.form.elements.loaders">Kapitel Element Plugins</link> für
 155                         weitere Informationen über gültige <varname>$type</varname> Werte. Wenn kein
 156                     <varname>$type</varname> spezifiziert wurde, nimmt diese Methode an das ein
 157                     genereller Präfix für alle Typen spezifiziert wurde.
 158                 </para>
 159             </listitem>
 160
 161             <listitem>
 162                 <para>
 163                     <methodname>addDisplayGroupPrefixPath($prefix, $path)</methodname>: Wie
 164                     <methodname>addPrefixPath()</methodname> nur das Klassenpräfix und ein Pfad
 165                     spezifiziert werden muß; Trotzdem, da Anzeigegruppen nur Dekoratore als Plugin
 166                     unterstützen, ist kein <varname>$type</varname> notwendig.
 167                 </para>
 168             </listitem>
 169         </itemizedlist>
 170
 171         <para>
 172             Eigene Elemente und Dekoratore sind ein einfacher Weg um Funktionalitäten zwischen
 173             Forms zu teilen und eigene Funktionalitäten zu kapseln. Siehe das
 174             <link linkend="zend.form.elements.loaders.customLabel">Eigene Label Beispiel</link> in
 175             der Dokumentation über Elemente als Beispiel dafür, wie eigene Elemente als Ersatz für
 176             Standardklassen verwendet werden können.
 177         </para>
 178     </sect2>
 179
 180     <sect2 id="zend.form.forms.elements">
 181         <title>Elemente</title>
 182
 183         <para>
 184             <classname>Zend_Form</classname> bietet verschiedene Zugriffsmethoden für das Hinzufügen
 185             und Entfernen von Elementen aus einer Form. Diese können Instanzen von Elemente Objekten
 186             nehmen oder als Factories für das Instanzieren der Element Objekte selbe herhalten.
 187         </para>
 188
 189         <para>
 190             Die grundsätzlichste Methode für das Hinzufügen eines Elements ist
 191             <methodname>addElement()</methodname>. Diese Methode kann entweder ein Objekt vom Typ
 192             <classname>Zend_Form_Element</classname> sein (oder einer Klasse die
 193             <classname>Zend_Form_Element</classname> erweitert), oder Argumente für das Erstellen
 194             eines neuen Elements -- inklusive dem Elementtyp, Namen, und jegliche
 195             Konfigurationsoption.
 196         </para>
 197
 198         <para>
 199             Einige Beispiele:
 200         </para>
 201
 202         <programlisting language="php"><![CDATA[
 203 // Eine Instanz eines Elements verwenden:
 204 $element = new Zend_Form_Element_Text('foo');
 205 $form->addElement($element);
 206
 207 // Eine Factory verwenden
 208 //
 209 // Erstellt ein Element von Typ Zend_Form_Element_Text mit dem
 210 // Namen 'foo':
 211 $form->addElement('text', 'foo');
 212
 213 // Eine Label Option an das Element übergeben:
 214 $form->addElement('text', 'foo', array('label' => 'Foo:'));
 215 ]]></programlisting>
 216
 217         <note>
 218             <title>addElement() implementiert das Fluent Interface</title>
 219
 220             <para>
 221                 <methodname>addElement()</methodname> implementiert das Fluent Interface; das heißt
 222                 es gibt das <classname>Zend_Form</classname> Objekt zurück und nicht das Element.
 223                 Das wird getan um es zu erlauben das mehrere addElement() Methoden gekettet werden
 224                 können oder andere Methoden die das Fluent Interface implementieren (alle Setzer in
 225                 <classname>Zend_Form</classname> implementieren dieses Pattern).
 226             </para>
 227
 228             <para>
 229                 Wenn das Element zurückgegeben werden soll, muß stattdessen
 230                 <methodname>createElement()</methodname> verwendet werden, welches anbei beschrieben
 231                 wird. Trotzdem vorsicht, da <methodname>createElement()</methodname> das Element
 232                 nicht der Form hinzufügt.
 233             </para>
 234
 235             <para>
 236                 <methodname>addElement()</methodname> verwendet intern
 237                 <methodname>createElement()</methodname> um das Element zu erstellen bevor es der
 238                 Form hinzugefügt wird.
 239             </para>
 240         </note>
 241
 242         <para>
 243             Sobald ein Element der Form hinzugefügt wurde, kann es durch den Namen empfangen
 244             werden. Das kann entweder durch die Verwendung der <methodname>getElement()</methodname>
 245             Methode, oder durch Verwendung von Überladen um auf das Element als Objekteigenschaft
 246             zuzugreifen:
 247         </para>
 248
 249         <programlisting language="php"><![CDATA[
 250 // getElement():
 251 $foo = $form->getElement('foo');
 252
 253 // Als Objekteigenschaft:
 254 $foo = $form->foo;
 255 ]]></programlisting>
 256
 257         <para>
 258             Fallweise, will man ein Element erstellen ohne es einer Form hinzuzufügen (zum
 259             Beispiel, wenn man die verschiedenen Plugin Pfade verwenden, aber das Objekt später zu
 260             einer Subform hinzufügen will). Die <methodname>createElement()</methodname> Methode
 261             erlaubt das:
 262         </para>
 263
 264         <programlisting language="php"><![CDATA[
 265 // $username wird ein Zend_Form_Element_Text Objekt:
 266 $username = $form->createElement('text', 'username');
 267 ]]></programlisting>
 268
 269         <sect3 id="zend.form.forms.elements.values">
 270             <title>Werte bekanntgeben und empfangen</title>
 271
 272             <para>
 273                 Nach der Prüfung einer Form, will man typischerweise die Werte empfangen damit
 274                 andere Operationen durchgeführt werden können, wie das Aktualisieren einer
 275                 Datenbank oder der Abfrage eines Web Services. Es können alle Werte für alle
 276                 Elemente empfangen werden durch Verwendung von <methodname>getValues()</methodname>;
 277                 <methodname>getValue($name)</methodname> erlabt es ausserdem den Wert eines
 278                 einzelnen Elements durch den Elementnamen zu erhalten:
 279             </para>
 280
 281             <programlisting language="php"><![CDATA[
 282 // Alle Werte erhalten:
 283 $values = $form->getValues();
 284
 285 // Nur den Wert des 'foo' Elements erhalten:
 286 $value = $form->getValue('foo');
 287 ]]></programlisting>
 288
 289             <para>
 290                 Manchmal soll die Form mit spezifizierten Werte veröffentlicht werden bevor Sie
 291                 dargestellt wird. Das kann entweder mit den <methodname>setDefaults()</methodname>
 292                 oder <methodname>populate()</methodname> Methoden getan werden:
 293             </para>
 294
 295             <programlisting language="php"><![CDATA[
 296 $form->setDefaults($data);
 297 $form->populate($data);
 298 ]]></programlisting>
 299
 300             <para>
 301                 Auf der anderen Seiten kann es gewünscht sein ein Formular, nach der Übertragung
 302                 oder der Prüfung, zu löschen; das kann durch Verwendung der
 303                 <methodname>reset()</methodname> Methode durchgeführt werden:
 304             </para>
 305
 306             <programlisting language="php"><![CDATA[
 307 $form->reset();
 308 ]]></programlisting>
 309         </sect3>
 310
 311         <sect3 id="zend.form.forms.elements.global">
 312             <title>Globale Operationen</title>
 313
 314             <para>
 315                 Fallweise wird man wollen das bestimmte Operationen alle Elemente beeinflussen.
 316                 Übliche Szenarien enthalten das Setzen des Plugin Präfix Pfades für alle Elemente,
 317                 Setzen der Dekoratore für alle Elemente, und das setzen von Filtern für alle
 318                 Elemente. Als Beispiel:
 319             </para>
 320
 321             <example id="zend.form.forms.elements.global.allpaths">
 322                 <title>Setzen von Präfix Pfaden für alle Elemente</title>
 323
 324                 <para>
 325                     Präfix Pfade können für alle Elemente durch den Typ oder der Verwendung eines
 326                     globalen Präfix gesetzt werden. Einige Beispiele:
 327                 </para>
 328
 329                 <programlisting language="php"><![CDATA[
 330 // Einen gobalen Präfix setzen:
 331 // Erstellt Pfade für die Präfixe My_Foo_Filter, My_Foo_Validate,
 332 // und My_Foo_Decorator
 333 $form->addElementPrefixPath('My_Foo', 'My/Foo/');
 334
 335 // Nur Filterpfade:
 336 $form->addElementPrefixPath('My_Foo_Filter',
 337                             'My/Foo/Filter',
 338                             'filter');
 339
 340 // Nur Prüfungspfade:
 341 $form->addElementPrefixPath('My_Foo_Validate',
 342                             'My/Foo/Validate',
 343                             'validate');
 344
 345 // Nur Dekoratorpfade:
 346 $form->addElementPrefixPath('My_Foo_Decorator',
 347                             'My/Foo/Decorator',
 348                             'decorator');
 349 ]]></programlisting>
 350             </example>
 351
 352             <example id="zend.form.forms.elements.global.decorators">
 353                 <title>Dekoratore für alle Elemente setzen</title>
 354
 355                 <para>
 356                     Man kann Dekoratore für alle Elemente setzen.
 357                     <methodname>setElementDecorators()</methodname> akzeptiert ein Array von
 358                     Dekoratoren, wie <methodname>setDecorators()</methodname>, und überschreibt
 359                     jeden vorher gesetzten Dekorator in jedem Element. In diesem Beispiel wird der
 360                     Dekorator einfach auf einen ViewHelfer und ein Label gesetzt:
 361                 </para>
 362
 363                 <programlisting language="php"><![CDATA[
 364 $form->setElementDecorators(array(
 365     'ViewHelper',
 366     'Label'
 367 ));
 368 ]]></programlisting>
 369             </example>
 370
 371             <example id="zend.form.forms.elements.global.decoratorsFilter">
 372                 <title>Setzen von Dekoratoren für einige Elemente</title>
 373
 374                 <para>
 375                     Man kann Dekoratore auch für ein Subset von Elementen setzen, entweder durch
 376                     Ausbeziehung oder durch Ausgrenzung. Das zweite Argument von
 377                     <methodname>setElementDecorators()</methodname> kann ein Array von Elementnamen
 378                     sein; standardmäßig setzt so ein Array den spezifizierten Dekrator nur auf diese
 379                     Elemente. Man kann auch einen dritten Parameter angeben, ein Flag das anzeigt ob
 380                     diese Liste von Elementen einbezogen oder ausgegrenzt werden sollen. Wenn das
 381                     Flag <constant>FALSE</constant> ist, werden alle Elemente dekoriert
 382                     <emphasis>ausser</emphasis> denen die in der Liste übergeben wurden. Die normale
 383                     Verwendung der Methode besteht darin, das alle übergebenen Dekoratore alle
 384                     vorher gesetzten Dekoratore in jedem Element überschreiben.
 385                 </para>
 386
 387                 <para>
 388                     Im folgenden Schnipsel, sagen wir das wir nur die ViewHelper und Label
 389                     Dekoratore für die 'foo' und 'bar' Elemente haben wollen:
 390                 </para>
 391
 392                 <programlisting language="php"><![CDATA[
 393 $form->setElementDecorators(
 394     array(
 395         'ViewHelper',
 396         'Label'
 397     ),
 398     array(
 399         'foo',
 400         'bar'
 401     )
 402 );
 403 ]]></programlisting>
 404
 405                 <para>
 406                     Auf der anderen Seite zeigt dieses Schnipsel jetzt an das nur nur die ViewHelper
 407                     und Label Dekoratore für jedes Element verwenden wollen
 408                     <emphasis>ausgenommen</emphasis> die 'foo' und 'bar' Elemente:
 409                 </para>
 410
 411                 <programlisting language="php"><![CDATA[
 412 $form->setElementDecorators(
 413     array(
 414         'ViewHelper',
 415         'Label'
 416     ),
 417     array(
 418         'foo',
 419         'bar'
 420     ),
 421     false
 422 );
 423 ]]></programlisting>
 424             </example>
 425
 426             <note>
 427                 <title>Einige Dekoratore sind für einige Elemente ungeeignet</title>
 428
 429                 <para>
 430                     Wärend <methodname>setElementDecorators()</methodname> wie eine gute Lösung
 431                     ausschaut gibt es einige Fälle in denen es zu unerwarteten Ergebnissen führen
 432                     kann. Zum Beispiel verwenden die verschiedenen Button Elemente (Submit, Button,
 433                     Reset) aktuell das Label als Wert des Buttons, und verwenden nur den
 434                     ViewHelper und DtDdWrapper Dekorator -- was zusätzliche Labels, Fehler und
 435                     Hinweise für die Darstellung verhindert. Das obige Beispiel würde einige
 436                     Inhalte (das Label) für Button Elemente duplizieren.
 437                 </para>
 438
 439                 <para>
 440                     Man kann das Enthalten/Ausnehmen Array verwenden um dieses Problem, wie im
 441                     vorherigen Beispiel gezeigt, zu umgehen.
 442                 </para>
 443
 444                 <para>
 445                     Diese Methode sollte also weise verwendet werden und man sollte bedenken
 446                     das man einige Dekoratore von Elementen händisch ändern muss damit
 447                     ungewollte Ausgaben verhindert werden.
 448                 </para>
 449             </note>
 450
 451             <example id="zend.form.forms.elements.global.filters">
 452                 <title>Filter für alle Elemente setzen</title>
 453
 454                 <para>
 455                     In einigen Fällen will man den selben Filter auf alle Elemente anwenden; ein
 456                     üblicher Fall ist es alle Werte zu <methodname>trim()</methodname>men:
 457                 </para>
 458
 459                 <programlisting language="php"><![CDATA[
 460 $form->setElementFilters(array('StringTrim'));
 461 ]]></programlisting>
 462             </example>
 463         </sect3>
 464
 465         <sect3 id="zend.form.forms.elements.methods">
 466             <title>Methoden für die Interaktion mit Elementen</title>
 467
 468             <para>
 469                 Die folgenden Methoden können verwendet werden um mit Elementen zu interagieren:
 470             </para>
 471
 472             <itemizedlist>
 473                 <listitem>
 474                     <para>
 475                         <methodname>createElement($element, $name = null, $options =
 476                             null)</methodname>
 477                     </para>
 478                 </listitem>
 479
 480                 <listitem>
 481                     <para>
 482                         <methodname>addElement($element, $name = null, $options = null)</methodname>
 483                     </para>
 484                 </listitem>
 485
 486                 <listitem>
 487                     <para><methodname>addElements(array $elements)</methodname></para>
 488                 </listitem>
 489
 490                 <listitem>
 491                     <para><methodname>setElements(array $elements)</methodname></para>
 492                 </listitem>
 493
 494                 <listitem><para><methodname>getElement($name)</methodname></para></listitem>
 495                 <listitem><para><methodname>getElements()</methodname></para></listitem>
 496                 <listitem><para><methodname>removeElement($name)</methodname></para></listitem>
 497                 <listitem><para><methodname>clearElements()</methodname></para></listitem>
 498
 499                 <listitem>
 500                     <para><methodname>setDefaults(array $defaults)</methodname></para>
 501                 </listitem>
 502
 503                 <listitem><para><methodname>setDefault($name, $value)</methodname></para></listitem>
 504                 <listitem><para><methodname>getValue($name)</methodname></para></listitem>
 505                 <listitem><para><methodname>getValues()</methodname></para></listitem>
 506                 <listitem><para><methodname>getUnfilteredValue($name)</methodname></para></listitem>
 507                 <listitem><para><methodname>getUnfilteredValues()</methodname></para></listitem>
 508
 509                 <listitem>
 510                     <para><methodname>setElementFilters(array $filters)</methodname></para>
 511                 </listitem>
 512
 513                 <listitem>
 514                     <para><methodname>setElementDecorators(array $decorators)</methodname></para>
 515                 </listitem>
 516
 517                 <listitem>
 518                     <para>
 519                         <methodname>addElementPrefixPath($prefix, $path, $type = null)</methodname>
 520                     </para>
 521                 </listitem>
 522
 523                 <listitem>
 524                     <para><methodname>addElementPrefixPaths(array $spec)</methodname></para>
 525                 </listitem>
 526             </itemizedlist>
 527         </sect3>
 528     </sect2>
 529
 530     <sect2 id="zend.form.forms.displaygroups">
 531         <title>Anzeigegruppen</title>
 532
 533         <para>
 534             Anzeigegruppen sind ein Weg um virtuell Gruppierungen von Elementen für Anzeigezwecke
 535             zu erstellen. Alle Elemente bleiben durch Ihren Namen in der Form zugreifbar, aber wenn
 536             die Form iteriert oder dargestellt wird, werden alle Elemente in Anzeigegruppen
 537             gemeinsam dargestellt. Üblicherweise wird das für die Gruppierung von Elementen in
 538             Fieldsets verwendet.
 539         </para>
 540
 541         <para>
 542             Die Basisklasse für Anzeigegruppen ist <classname>Zend_Form_DisplayGroup</classname>.
 543             Wärend Sie direkt Instanziert werden kann, ist es normalerweise am besten die
 544             <methodname>addDisplayGroup()</methodname> Methode von <classname>Zend_Form</classname>
 545             zu verwenden um das zu erledigen. Diese Methode nimmt ein Array von Elementen als erstes
 546             Argument, und einen Namen für die Anzeigegruppe als zweites Argument. Es kann optional
 547             ein Array von Optionen oder ein <classname>Zend_Config</classname> Objekt als drittes
 548             Argument übergeben werden.
 549         </para>
 550
 551         <para>
 552             Angenommen das die Elemente 'username' und 'passwort' bereits in der Form gesetzt
 553             wurden. Dann würde der folgende Code diese Elemente in einer 'login' Anzeigegruppe
 554             gruppieren:
 555         </para>
 556
 557         <programlisting language="php"><![CDATA[
 558 $form->addDisplayGroup(array('username', 'password'), 'login');
 559 ]]></programlisting>
 560
 561         <para>
 562             Auf Displaygruppen kann mithilfe der <methodname>getDisplayGroup()</methodname> Methode
 563             zugegriffen werden, oder über Überladung inden der Name der Anzeigegruppe verwendet
 564             wird:
 565         </para>
 566
 567         <programlisting language="php"><![CDATA[
 568 // getDisplayGroup() verwenden:
 569 $login = $form->getDisplayGroup('login');
 570
 571 // Überladen verwenden:
 572 $login = $form->login;
 573 ]]></programlisting>
 574
 575         <note>
 576             <title>Standarddekoratore müssen nicht geladen werden</title>
 577
 578             <para>
 579                 Standardmäßig werden die Standarddekoratore wärend der Initialisierung des Objektes
 580                 geladen. Das kann durch die Übergabe der 'disableLoadDefaultDecorators' Option, bei
 581                 der Erstellung der Anzeigegruppe, deaktiviert werden:
 582             </para>
 583
 584             <programlisting language="php"><![CDATA[
 585 $form->addDisplayGroup(
 586     array('foo', 'bar'),
 587     'foobar',
 588     array('disableLoadDefaultDecorators' => true)
 589 );
 590 ]]></programlisting>
 591
 592             <para>
 593                 Diese Option kann mit jeder anderen Option gemischt werden die übergeben wird,
 594                 sowohl als Array Option als auch in einem <classname>Zend_Config</classname> Objekt.
 595             </para>
 596         </note>
 597
 598         <sect3 id="zend.form.forms.displaygroups.global">
 599             <title>Globale Operationen</title>
 600
 601             <para>
 602                 Wie bei den Elementen gibt es einige Operationen welche alle Anzeigegruppen
 603                 beeinflussen; diese inkludieren das Setzen von Dekoratoren und Setzen des Plugin
 604                 Pfades in denen nach Dekoratoren nachgesehen werden soll.
 605             </para>
 606
 607             <example id="zend.form.forms.displaygroups.global.paths">
 608                 <title>Setzen des Dekorator Präfix Pfades für alle Anzeigegruppen</title>
 609
 610                 <para>
 611                     Standardmäßig erben Anzeigegruppen die Dekorator Pfade welche die Form
 612                     verwendet; wenn trotzdem in alternativen Orten nachgeschaut werden soll kann die
 613                     <methodname>addDisplayGroupPrefixPath()</methodname> Methode verwendet werden.
 614                 </para>
 615
 616                 <programlisting language="php"><![CDATA[
 617 $form->addDisplayGroupPrefixPath('My_Foo_Decorator', 'My/Foo/Decorator');
 618 ]]></programlisting>
 619             </example>
 620
 621             <example id="zend.form.forms.displaygroups.global.decorators">
 622                 <title>Setzen von Dekoratoren für alle Anzeigegruppen</title>
 623
 624                 <para>
 625                     Es können Dekoratore für alle Anzeigegruppen gesetzt werden.
 626                     <methodname>setDisplayGroupDecorators()</methodname> akzeptiert ein Array von
 627                     Dekoratoren, wie <methodname>setDecorators()</methodname>, und überschreibt alle
 628                     vorher gesetzten Dekoratore in jeder Anzeigegruppe. In diesem Beispiel setzen
 629                     wir die Dekoratore einfach auf ein Fieldset (der FormElements Dekorator ist
 630                     notwendig um sicherzustellen das die Elemente iterierbar sind):
 631                 </para>
 632
 633                 <programlisting language="php"><![CDATA[
 634 $form->setDisplayGroupDecorators(array(
 635     'FormElements',
 636     'Fieldset'
 637 ));
 638 ]]></programlisting>
 639             </example>
 640         </sect3>
 641
 642         <sect3 id="zend.form.forms.displaygroups.customClasses">
 643             <title>Eigene Anzeigegruppen Klassen verwenden</title>
 644
 645             <para>
 646                 Standardmäßig verwendet <classname>Zend_Form</classname> die
 647                 <classname>Zend_Form_DisplayGroup</classname> Klasse für Anzeigegruppen. Man kann
 648                 diese Klasse erweitern um eigene Funktionalitäten anzubieten.
 649                 <methodname>addDisplayGroup()</methodname> erlaubt es nicht eine konkrete Instanz zu
 650                 übergeben, aber sie erlaubt es eine Klasse zu spezifizieren die als eine
 651                 Ihrer Optionen verwendet wird, indem der 'displayGroupClass' Schlüssel verwendet
 652                 wird:
 653             </para>
 654
 655             <programlisting language="php"><![CDATA[
 656 // Verwenden der 'My_DisplayGroup' Klasse
 657 $form->addDisplayGroup(
 658     array('username', 'password'),
 659     'user',
 660     array('displayGroupClass' => 'My_DisplayGroup')
 661 );
 662 ]]></programlisting>
 663
 664             <para>
 665                 Wenn die Klasse noch nicht geladen wurde, versucht <classname>Zend_Form</classname>
 666                 das zu tun, indem <classname>Zend_Loader</classname> verwendet wird.
 667             </para>
 668
 669             <para>
 670                 Es kann auch eine eine Standardklasse für Anzeigegruppen definiert werden die mit
 671                 der Form zu verwenden ist, sodas alle Anzeigegrupen die mit dem Form Objekt
 672                 erstellt werden diese Klasse verwenden:
 673             </para>
 674
 675             <programlisting language="php"><![CDATA[
 676 // Verwenden der Klasse 'My_DisplayGroup' für alle Anzeigegruppen:
 677 $form->setDefaultDisplayGroupClass('My_DisplayGroup');
 678 ]]></programlisting>
 679
 680             <para>
 681                 Diese Einstellung kann in Konfigurationen als 'defaultDisplayGroupClass'
 682                 spezifiziert werden, und wird früh geladen um sicherzustellen das alle
 683                 Anzeigegruppen diese Klasse verwenden.
 684             </para>
 685         </sect3>
 686
 687         <sect3 id="zend.form.forms.displaygroups.interactionmethods">
 688             <title>Methoden für die Interaktion mit Anzeigegruppen</title>
 689
 690             <para>
 691                 Die folgenden Methoden können verwendet werden um mit Anzeigegruppen zu
 692                 interagieren:
 693             </para>
 694
 695             <itemizedlist>
 696                 <listitem>
 697                     <para>
 698                         <methodname>addDisplayGroup(array $elements, $name, $options =
 699                             null)</methodname>
 700                     </para>
 701                 </listitem>
 702
 703                 <listitem>
 704                     <para><methodname>addDisplayGroups(array $groups)</methodname></para>
 705                 </listitem>
 706
 707                 <listitem>
 708                     <para><methodname>setDisplayGroups(array $groups)</methodname></para>
 709                 </listitem>
 710
 711                 <listitem><para><methodname>getDisplayGroup($name)</methodname></para></listitem>
 712                 <listitem><para><methodname>getDisplayGroups()</methodname></para></listitem>
 713                 <listitem><para><methodname>removeDisplayGroup($name)</methodname></para></listitem>
 714                 <listitem><para><methodname>clearDisplayGroups()</methodname></para></listitem>
 715
 716                 <listitem>
 717                     <para>
 718                         <methodname>setDisplayGroupDecorators(array $decorators)</methodname>
 719                     </para>
 720                 </listitem>
 721
 722                 <listitem>
 723                     <para><methodname>addDisplayGroupPrefixPath($prefix, $path)</methodname></para>
 724                 </listitem>
 725
 726                 <listitem>
 727                     <para><methodname>setDefaultDisplayGroupClass($class)</methodname></para>
 728                 </listitem>
 729
 730                 <listitem>
 731                     <para><methodname>getDefaultDisplayGroupClass($class)</methodname></para>
 732                 </listitem>
 733             </itemizedlist>
 734         </sect3>
 735
 736         <sect3 id="zend.form.forms.displaygroups.methods">
 737             <title>Methoden von Zend_Form_DisplayGroup</title>
 738
 739             <para>
 740                 <classname>Zend_Form_DisplayGroup</classname> hat die folgenden Methoden, gruppiert
 741                 nach Typ:
 742             </para>
 743
 744             <itemizedlist>
 745                 <listitem>
 746                     <para>Konfiguration:</para>
 747
 748                     <itemizedlist>
 749                         <listitem>
 750                             <para><methodname>setOptions(array $options)</methodname></para>
 751                         </listitem>
 752
 753                         <listitem>
 754                             <para><methodname>setConfig(Zend_Config $config)</methodname></para>
 755                         </listitem>
 756                     </itemizedlist>
 757                 </listitem>
 758
 759                 <listitem>
 760                     <para>Metadaten:</para>
 761
 762                     <itemizedlist>
 763                         <listitem>
 764                             <para><methodname>setAttrib($key, $value)</methodname></para>
 765                         </listitem>
 766
 767                         <listitem>
 768                             <para><methodname>addAttribs(array $attribs)</methodname></para>
 769                         </listitem>
 770
 771                         <listitem>
 772                             <para><methodname>setAttribs(array $attribs)</methodname></para>
 773                         </listitem>
 774
 775                         <listitem><para><methodname>getAttrib($key)</methodname></para></listitem>
 776                         <listitem><para><methodname>getAttribs()</methodname></para></listitem>
 777
 778                         <listitem>
 779                             <para><methodname>removeAttrib($key)</methodname></para>
 780                         </listitem>
 781
 782                         <listitem><para><methodname>clearAttribs()</methodname></para></listitem>
 783                         <listitem><para><methodname>setName($name)</methodname></para></listitem>
 784                         <listitem><para><methodname>getName()</methodname></para></listitem>
 785
 786                         <listitem>
 787                             <para><methodname>setDescription($value)</methodname></para>
 788                         </listitem>
 789
 790                         <listitem><para><methodname>getDescription()</methodname></para></listitem>
 791
 792                         <listitem>
 793                             <para><methodname>setLegend($legend)</methodname></para>
 794                         </listitem>
 795
 796                         <listitem><para><methodname>getLegend()</methodname></para></listitem>
 797                         <listitem><para><methodname>setOrder($order)</methodname></para></listitem>
 798                         <listitem><para><methodname>getOrder()</methodname></para></listitem>
 799                     </itemizedlist>
 800                 </listitem>
 801
 802                 <listitem>
 803                     <para>Elemente:</para>
 804
 805                     <itemizedlist>
 806                         <listitem>
 807                             <para>
 808                                 <methodname>createElement($type, $name, array $options =
 809                                     array())</methodname>
 810                             </para>
 811                         </listitem>
 812
 813                         <listitem>
 814                             <para>
 815                                 <methodname>addElement($typeOrElement, $name, array $options =
 816                                     array())</methodname>
 817                             </para>
 818                         </listitem>
 819
 820                         <listitem>
 821                             <para><methodname>addElements(array $elements)</methodname></para>
 822                         </listitem>
 823
 824                         <listitem>
 825                             <para><methodname>setElements(array $elements)</methodname></para>
 826                         </listitem>
 827
 828                         <listitem><para><methodname>getElement($name)</methodname></para></listitem>
 829
 830                         <listitem><para><methodname>getElements()</methodname></para></listitem>
 831
 832                         <listitem>
 833                             <para><methodname>removeElement($name)</methodname></para>
 834                         </listitem>
 835
 836                         <listitem><para><methodname>clearElements()</methodname></para></listitem>
 837                     </itemizedlist>
 838                 </listitem>
 839
 840                 <listitem>
 841                     <para>Plugin Loader:</para>
 842
 843                     <itemizedlist>
 844                         <listitem>
 845                             <para>
 846                                 <methodname>setPluginLoader(Zend_Loader_PluginLoader
 847                                     $loader)</methodname>
 848                             </para>
 849                         </listitem>
 850
 851                         <listitem><para><methodname>getPluginLoader()</methodname></para></listitem>
 852
 853                         <listitem>
 854                             <para><methodname>addPrefixPath($prefix, $path)</methodname></para>
 855                         </listitem>
 856
 857                         <listitem>
 858                             <para><methodname>addPrefixPaths(array $spec)</methodname></para>
 859                         </listitem>
 860                     </itemizedlist>
 861                 </listitem>
 862
 863                 <listitem>
 864                     <para>Dekoratore:</para>
 865
 866                     <itemizedlist>
 867                         <listitem>
 868                             <para>
 869                                 <methodname>addDecorator($decorator, $options = null)</methodname>
 870                             </para>
 871                         </listitem>
 872
 873                         <listitem>
 874                             <para><methodname>addDecorators(array $decorators)</methodname></para>
 875                         </listitem>
 876
 877                         <listitem>
 878                             <para><methodname>setDecorators(array $decorators)</methodname></para>
 879                         </listitem>
 880
 881                         <listitem>
 882                             <para><methodname>getDecorator($name)</methodname></para>
 883                         </listitem>
 884
 885                         <listitem><para><methodname>getDecorators()</methodname></para></listitem>
 886
 887                         <listitem>
 888                             <para><methodname>removeDecorator($name)</methodname></para>
 889                         </listitem>
 890
 891                         <listitem><para><methodname>clearDecorators()</methodname></para></listitem>
 892                     </itemizedlist>
 893                 </listitem>
 894
 895                 <listitem>
 896                     <para>Darstellung:</para>
 897
 898                     <itemizedlist>
 899                         <listitem>
 900                             <para>
 901                                 <methodname>setView(Zend_View_Interface $view = null)</methodname>
 902                             </para>
 903                         </listitem>
 904
 905                         <listitem><para><methodname>getView()</methodname></para></listitem>
 906
 907                         <listitem>
 908                             <para>
 909                                 <methodname>render(Zend_View_Interface $view = null)</methodname>
 910                             </para>
 911                         </listitem>
 912                     </itemizedlist>
 913                 </listitem>
 914
 915                 <listitem>
 916                     <para>I18n:</para>
 917
 918                     <itemizedlist>
 919                         <listitem>
 920                             <para>
 921                                 <methodname>setTranslator(Zend_Translate_Adapter $translator =
 922                                     null)</methodname>
 923                             </para>
 924                         </listitem>
 925
 926                         <listitem><para><methodname>getTranslator()</methodname></para></listitem>
 927
 928                         <listitem>
 929                             <para><methodname>setDisableTranslator($flag)</methodname></para>
 930                         </listitem>
 931
 932                         <listitem>
 933                             <para><methodname>translatorIsDisabled()</methodname></para>
 934                         </listitem>
 935                     </itemizedlist>
 936                 </listitem>
 937             </itemizedlist>
 938         </sect3>
 939     </sect2>
 940
 941     <sect2 id="zend.form.forms.subforms">
 942         <title>Subformen</title>
 943
 944         <para>
 945             Subformen haben unterschiedliche Zwecke:
 946         </para>
 947
 948         <itemizedlist>
 949             <listitem>
 950                 <para>
 951                     Erstellung von logischen Element Gruppen. Da Subformen einfach Formen sind,
 952                     können Sie auch wie individuelle Einheiten geprüft werden.
 953                 </para>
 954             </listitem>
 955
 956             <listitem>
 957                 <para>
 958                     Erstellung von Multi-Seiten Formen. Da Subformen einfach Formen sind, kann eine
 959                     separate Subform pro Seite angezeigt werden, um Multi-Seiten Formen zu bauen in
 960                     denen jede Form seine eigene Prüflogik besitzt. Nur sobald alle Subformen
 961                     geprüft wurden würde die Form als komplett angenommen werden.
 962                 </para>
 963             </listitem>
 964
 965             <listitem>
 966                 <para>
 967                     Anzeige Gruppierungen. Wie Anzeigegruppen, können Subformen, wenn Sie als Teil
 968                     einer größeren Form dargestellt werden, verwendet werden um Elemente zu
 969                     gruppieren. Trotzdem muß darauf geachtet werden dass das Hauptform Objekt keine
 970                     Ahnung von den Elementen in Subformen besitzt.
 971                 </para>
 972             </listitem>
 973         </itemizedlist>
 974
 975         <para>
 976             Eine Subform kann ein <classname>Zend_Form</classname> Objekt sein, oder typischerweise
 977             ein <classname>Zend_Form_SubForm</classname> Objekt. Das zweitere enthält Dekoratore die
 978             für das Einfügen in größere Formen passen (z.B. gibt es keine zusätzlichen
 979             <acronym>HTML</acronym> form Tags aus, gruppiert aber Elemente). Um eine Subform
 980             anzuhängen, muß diese einfach der Form hinzugefügt und ein Name vergeben werden:
 981         </para>
 982
 983         <programlisting language="php"><![CDATA[
 984 $form->addSubForm($subForm, 'subform');
 985 ]]></programlisting>
 986
 987         <para>
 988             Eine Subform kann empfangen werden indem entweder
 989             <methodname>getSubForm($name)</methodname> oder Überladung mithilfe des Namens der
 990             Subform verwendet wird:
 991         </para>
 992
 993         <programlisting language="php"><![CDATA[
 994 // Verwenden von getSubForm():
 995 $subForm = $form->getSubForm('subform');
 996
 997 // Verwenden von Überladen:
 998 $subForm = $form->subform;
 999 ]]></programlisting>
1000
1001         <para>
1002             Subformen sind bei der Iteration der Form enthalten, aber die Elemente die Sie enthalten
1003             nicht.
1004         </para>
1005
1006         <sect3 id="zend.form.forms.subforms.global">
1007             <title>Globale Operationen</title>
1008
1009             <para>
1010                 Wie Elemente und Anzeigegruppen. gibt es einige Operationen für die es notwendig
1011                 ist alle Subformen zu bearbeiten. Anders als Anzeigegruppen und Elemente, erben
1012                 Subformen die meisten Funktionalitäten vom Hauptform Objekt, und die einzige
1013                 wirklich Operation die durchgeführt werden sollte, ist das Setzen der Dekoratore
1014                 für Subformen. Für diesen Zweck, gibt es die
1015                 <methodname>setSubFormDecorators()</methodname> Methode. Im nächsten Beispiel setzen
1016                 wir den Dekorator für alle Subformen einfach auf ein Fieldset (der FormElements
1017                 Dekorator wird benötigt um sicherzustellen das seine Elemente iterierbar sind):
1018             </para>
1019
1020             <programlisting language="php"><![CDATA[
1021 $form->setSubFormDecorators(array(
1022     'FormElements',
1023     'Fieldset'
1024 ));
1025 ]]></programlisting>
1026         </sect3>
1027
1028         <sect3 id="zend.form.forms.subforms.methods">
1029             <title>Methoden für die Interaktion mit Subfomen</title>
1030
1031             <para>
1032                 Die folgenden Meothden können verwendet werden um mit Subformen zu interagieren:
1033             </para>
1034
1035             <itemizedlist>
1036                 <listitem>
1037                     <para>
1038                         <methodname>addSubForm(Zend_Form $form, $name, $order = null)</methodname>
1039                     </para>
1040                 </listitem>
1041
1042                 <listitem>
1043                     <para><methodname>addSubForms(array $subForms)</methodname></para>
1044                 </listitem>
1045
1046                 <listitem>
1047                     <para><methodname>setSubForms(array $subForms)</methodname></para>
1048                 </listitem>
1049
1050                 <listitem><para><methodname>getSubForm($name)</methodname></para></listitem>
1051                 <listitem><para><methodname>getSubForms()</methodname></para></listitem>
1052                 <listitem><para><methodname>removeSubForm($name)</methodname></para></listitem>
1053                 <listitem><para><methodname>clearSubForms()</methodname></para></listitem>
1054
1055                 <listitem>
1056                     <para>
1057                         <methodname>setSubFormDecorators(array $decorators)</methodname>
1058                     </para>
1059                 </listitem>
1060             </itemizedlist>
1061         </sect3>
1062     </sect2>
1063
1064     <sect2 id="zend.form.forms.metadata">
1065         <title>Metadaten und Attribute</title>
1066
1067         <para>
1068             Wärend die Nützlichkeit von Formen primär von den Elementen die Sie enthalten her
1069             rührt, enthhalten Sie auch anderen Metadaten, wie einen Namen (oft verwendet als
1070             eindeutige ID im <acronym>HTML</acronym> Markup); die Aktion und Methode der Form; die
1071             Anzahl an Elementen, Gruppen, und Subformen die Sie enthält; und sonstige Metadaten (die
1072             normalerweise verwendet werden um <acronym>HTML</acronym> Attribute für das Form Tag
1073             selbst zu setzen).
1074         </para>
1075
1076         <para>
1077             Der Name der Form kann mithilfe der name Zugriffsmethoden gesetzt und empfangen werden:
1078         </para>
1079
1080         <programlisting language="php"><![CDATA[
1081 // Den Namen setzen:
1082 $form->setName('registration');
1083
1084 // Den Namen empfangen:
1085 $name = $form->getName();
1086 ]]></programlisting>
1087
1088         <para>
1089             Um die Aktion (URL zu der die Form übermittelt) und Methode (Methode mit der
1090             übermittelt werden soll, 'POST' oder 'GET') zu setzen, können die Zugriffsmethoden für
1091             action und method verwendet werden:
1092         </para>
1093
1094         <programlisting language="php"><![CDATA[
1095 // action und method setzen:
1096 $form->setAction('/user/login')
1097      ->setMethod('post');
1098 ]]></programlisting>
1099
1100         <para>
1101             Man kann auch den Encoding Typ des Formulars spezifizieren indem die Enctype
1102             Zugriffsmethode verwendet wird. <classname>Zend_Form</classname> definiert zwei
1103             Konstanten, <constant>Zend_Form::ENCTYPE_URLENCODED</constant> und
1104             <constant>Zend_Form::ENCTYPE_MULTIPART</constant>, die den Werten
1105             'application/x-www-form-urlencoded' und 'multipart/form-data' entsprechen; trotzdem kann
1106             das auf jeden gewünschten Encodingtyp gesetzt werden.
1107         </para>
1108
1109         <programlisting language="php"><![CDATA[
1110 // Setzt die Aktion, Methoden, und Enctype:
1111 $form->setAction('/user/login')
1112      ->setMethod('post')
1113      ->setEnctype(Zend_Form::ENCTYPE_MULTIPART);
1114 ]]></programlisting>
1115
1116         <note>
1117             <para>
1118                 Methode, Aktion und Encodingtyp werden nur intern für die Darstellung verwendet,
1119                 und nicht für irgendeine Art von Prüfung.
1120             </para>
1121         </note>
1122
1123         <para>
1124             <classname>Zend_Form</classname> implementiert das <classname>Countable</classname>
1125             Interface, welches es erlaubt es als Argument fürs Zählen zu übergeben:
1126         </para>
1127
1128         <programlisting language="php"><![CDATA[
1129 $numItems = count($form);
1130 ]]></programlisting>
1131
1132         <para>
1133             Das Setzen von eigenen Metadaten wird durch die attribs Zugriffsmethode durchgeführt.
1134             Da Überladen in <classname>Zend_Form</classname> verwendet wird um auf Elemente,
1135             Anzeigegruppen, und Subformen zuzugreifen ist das die einzige Methode für den Zugriff
1136             auf Metadaten.
1137         </para>
1138
1139         <programlisting language="php"><![CDATA[
1140 // Setzen von Attributen:
1141 $form->setAttrib('class', 'zend-form')
1142      ->addAttribs(array(
1143          'id'       => 'registration',
1144          'onSubmit' => 'validate(this)',
1145      ));
1146
1147 // Empfangen von Attributen:
1148 $class = $form->getAttrib('class');
1149 $attribs = $form->getAttribs();
1150
1151 // Entfernen eines Attributes:
1152 $form->removeAttrib('onSubmit');
1153
1154 // Löschen aller Attribute:
1155 $form->clearAttribs();
1156 ]]></programlisting>
1157     </sect2>
1158
1159     <sect2 id="zend.form.forms.decorators">
1160         <title>Dekoratore</title>
1161
1162         <para>
1163             Das Erstellen des Markups für eine Form ist oft ein zeitintensiver Arbeitsschritt,
1164             speziell wenn man plant das selbe Markup wiederzuverwenden um Dinge zu zeigen wie
1165             Prüffehler, übermittelte Werte, usw. <classname>Zend_Form</classname>'s Antwort hierfür
1166             sind <emphasis>Dekoratore</emphasis>.
1167         </para>
1168
1169         <para>
1170             Dekoratore für <classname>Zend_Form</classname> Objekte können verwendet werden um eine
1171             Form darzustellen. Der FormElements Dekorator iteriert durch alle Elemente in einer Form
1172             -- Elemente, Anzeigegruppen, und Subformen -- stellt sie dar, und gibt das Ergebnis
1173             zurück. Zusätzliche Dekoratore können dann verwendet werden um diese Inhalte zu
1174             wrappen, sie anzufügen oder sie voranzustellen.
1175         </para>
1176
1177         <para>
1178             Die Standarddekoratore für <classname>Zend_Form</classname> sind FormElemente, HtmlTag
1179             (wrappt in einer Definitionsliste), und Form; der entsprechende Code für deren
1180             Erstellung ist wie folgt:
1181         </para>
1182
1183         <programlisting language="php"><![CDATA[
1184 $form->setDecorators(array(
1185     'FormElements',
1186     array('HtmlTag', array('tag' => 'dl')),
1187     'Form'
1188 ));
1189 ]]></programlisting>
1190
1191         <para>
1192             Das erstellt eine Ausgabe wie die folgende:
1193         </para>
1194
1195         <programlisting language="html"><![CDATA[
1196 <form action="/form/action" method="post">
1197 <dl>
1198 ...
1199 </dl>
1200 </form>
1201 ]]></programlisting>
1202
1203         <para>
1204             Jegliche Attribute die auf dem Form Objekt gesetzt sindwerden als
1205             <acronym>HTML</acronym> Attribute des <emphasis>&lt;form&gt;</emphasis> Tags verwendet.
1206         </para>
1207
1208         <note>
1209             <title>Standarddekoratore müssen nicht geladen werden</title>
1210
1211             <para>
1212                 Standardmäßig werden die Standarddekoratore wärend der Initialisierung des Objektes
1213                 geladen. Das kann durch die Übergabe der 'disableLoadDefaultDecorators' Option, bei
1214                 der Erstellung der Anzeigegruppe, deaktiviert werden:
1215             </para>
1216
1217             <programlisting language="php"><![CDATA[
1218 $form = new Zend_Form(array('disableLoadDefaultDecorators' => true));
1219 ]]></programlisting>
1220
1221             <para>
1222                 Diese Option kann mit jeder anderen Option gemischt werden die übergeben wird,
1223                 sowohl als Array Option als auch in einem <classname>Zend_Config</classname> Objekt.
1224             </para>
1225         </note>
1226
1227         <note>
1228             <title>Verwenden mehrerer Dekoratore des gleichen Typs</title>
1229
1230             <para>
1231                 Intern verwendet <classname>Zend_Form</classname> eine Dekorator Klasse als
1232                 Mechsnismus für das nachsehen wenn Dekoratore empfangen werden. Als Ergebnis können
1233                 mehrere Dekoratore nicht zur gleichen Zeit registriert werden; nachfolgende
1234                 Dekoratore würden einfach die vorher existierenden überschreiben.
1235             </para>
1236
1237             <para>
1238                 Um das zu umgehen können Aliase verwendet werden. Statt der Übergabe eines
1239                 Dekorators oder eines Dekoratornamens als erstes Argument an
1240                 <methodname>addDecorator()</methodname>, kann ein Array mit einem einzelnen Argument
1241                 übergeben werden, mit dem Alias der auf das Dekorator Objekt oder den Namen zeigt:
1242             </para>
1243
1244             <programlisting language="php"><![CDATA[
1245 // Alias zu 'FooBar':
1246 $form->addDecorator(array('FooBar' => 'HtmlTag'), array('tag' => 'div'));
1247
1248 // Und Ihn später empfangen:
1249 $form = $element->getDecorator('FooBar');
1250 ]]></programlisting>
1251
1252             <para>
1253                 In den <methodname>addDecorators()</methodname> und
1254                 <methodname>setDecorators()</methodname> Methoden muß die 'decorator' Option im
1255                 Array übergeben werden das den Dekorator repräsentiert:
1256             </para>
1257
1258             <programlisting language="php"><![CDATA[
1259 // Zwei 'HtmlTag' Dekoratore hinzufügen und einen mit 'FooBar' benennen:
1260 $form->addDecorators(
1261     array('HtmlTag', array('tag' => 'div')),
1262     array(
1263         'decorator' => array('FooBar' => 'HtmlTag'),
1264         'options' => array('tag' => 'dd')
1265     ),
1266 );
1267
1268 // Und Sie später empfangen:
1269 $htmlTag = $form->getDecorator('HtmlTag');
1270 $fooBar  = $form->getDecorator('FooBar');
1271 ]]></programlisting>
1272         </note>
1273
1274         <para>
1275             Man kann eigene Dekoratore für die Erzeugung der Form erstellen. Ein üblicher Grund
1276             hierfür ist, wenn man das exakte <acronym>HTML</acronym> weiß das man verwenden will;
1277             der Dekorator könnte das exakte <acronym>HTML</acronym> erstellen und es einfach
1278             zurückgeben, wobei potentiell die Dekoratore der individuellen Elemente oder
1279             Anzeigegruppen verwendet werden.
1280         </para>
1281
1282         <para>
1283             Die folgenden Methoden können verwendet werden um mit Dekoratoren zu interagieren:
1284         </para>
1285
1286         <itemizedlist>
1287                 <listitem>
1288                     <para><methodname>addDecorator($decorator, $options = null)</methodname></para>
1289                 </listitem>
1290
1291                 <listitem>
1292                     <para><methodname>addDecorators(array $decorators)</methodname></para>
1293                 </listitem>
1294
1295                 <listitem>
1296                     <para><methodname>setDecorators(array $decorators)</methodname></para>
1297                 </listitem>
1298
1299                 <listitem><para><methodname>getDecorator($name)</methodname></para></listitem>
1300                 <listitem><para><methodname>getDecorators()</methodname></para></listitem>
1301                 <listitem><para><methodname>removeDecorator($name)</methodname></para></listitem>
1302                 <listitem><para><methodname>clearDecorators()</methodname></para></listitem>
1303         </itemizedlist>
1304
1305         <para>
1306             <classname>Zend_Form</classname> verwendet auch das Überladen um die Darstellung von
1307             speziellen Dekoratoren zu erlauben. <methodname>__call()</methodname> interagiert mit
1308             Methoden die mit dem Text 'render' beginnen und verwendet den Rest des Methodennamens
1309             um nach einem Dekorator zu suchen; wenn er gefunden wird, wird dieser
1310             <emphasis>einzelne</emphasis> Dekorator dargestellt. Jedes Argument das dem
1311             Methodenaufruf übergeben wird, wird als Inhalt an die <methodname>render()</methodname>
1312             Methode des Dekorators übergeben. Als Beispiel:
1313         </para>
1314
1315         <programlisting language="php"><![CDATA[
1316 // Stellt nur den FormElements Dekorator dar:
1317 echo $form->renderFormElements();
1318
1319 // Stell nur den Fieldset Dekorator dar, und übergibt Inhalte:
1320 echo $form->renderFieldset("<p>Das ist der Fieldset Inhalt</p>");
1321 ]]></programlisting>
1322
1323         <para>
1324             Wenn der Dekorator nicht existiert, wird eine Exception geworfen.
1325         </para>
1326     </sect2>
1327
1328     <sect2 id="zend.form.forms.validation">
1329         <title>Prüfung</title>
1330
1331         <para>
1332             Ein primärer Verwendungszweck für Forms ist die Überprüfung von übermittelten Daten.
1333             <classname>Zend_Form</classname> erlaubt es eine komplette Form, eine teilweise Form,
1334             oder Antworten von XmlHttpRequests (AJAX) zu prüfen. Wenn die übertragenen Daten nicht
1335             gültig sind, hat es Methoden für das Empfangen der verschiedenen Fehlercodes und
1336             Nachrichten für Elemente und Subformen.
1337         </para>
1338
1339         <para>
1340             Um eine ganze Form zu prüfen, kann die <methodname>isValid()</methodname> Methode
1341             verwendet werden:
1342         </para>
1343
1344         <programlisting language="php"><![CDATA[
1345 if (!$form->isValid($_POST)) {
1346     // Prüfung fehlgeschlagen
1347 }
1348 ]]></programlisting>
1349
1350         <para>
1351             <methodname>isValid()</methodname> prüft jedes benötigte Element, und jedes nicht
1352             benötigte Element das in den übermittelten Daten enthalten ist.
1353         </para>
1354
1355         <para>
1356             Manchmal muß nur ein Subset der Daten geprüft werden; dafür kann
1357             <methodname>isValidPartial($data)</methodname> verwendet werden:
1358         </para>
1359
1360         <programlisting language="php"><![CDATA[
1361 if (!$form->isValidPartial($data)) {
1362     // Prüfung fehlgeschlagen
1363 }
1364 ]]></programlisting>
1365
1366         <para>
1367             <methodname>isValidPartial()</methodname> versucht nur die Teile zu prüfen für die es
1368             passende Elemente gibt; wenn ein Element nicht in den Daten repräsentiert ist, wird es
1369             übersprungen.
1370         </para>
1371
1372         <para>
1373             Wenn Elemente oder Gruppen von Elementen für eine <acronym>AJAX</acronym> Anfrage
1374             geprüft werden, wird üblicherweise ein Subset der Form geprüft, und die Antwort in
1375             <acronym>JSON</acronym> zurückgegeben. <methodname>processAjax()</methodname> führt das
1376             präzise durch:
1377         </para>
1378
1379         <programlisting language="php"><![CDATA[
1380 $json = $form->processAjax($data);
1381 ]]></programlisting>
1382
1383         <para>
1384             Man kann dann einfach die <acronym>JSON</acronym> Antwort an den Client senden. Wenn die
1385             Form gültig ist, wird das eine boolsche <constant>TRUE</constant> Antwort sein. Wenn
1386             nicht, wird es ein Javascript Objekt sein das Schlüssel/Nachricht Paare enthält, wobei
1387             jede Nachricht 'message' ein Array von Prüf-Fehlermeldungen enthält.
1388         </para>
1389
1390         <para>
1391             Für Forms bei denen die Prüfung fehlschlägt, können beide, Fehlercodes und
1392             Fehlermeldung empfangen werden, indem <methodname>getErrors()</methodname> und
1393             <methodname>getMessages()</methodname> verwendet werden:
1394         </para>
1395
1396         <programlisting language="php"><![CDATA[
1397 $codes = $form->getErrors();
1398 $messages = $form->getMessages();
1399 ]]></programlisting>
1400
1401         <note>
1402             <para>
1403                 Da die Nachrichten die von <methodname>getMessages()</methodname> zurückgegeben
1404                 werden in einem Array von Fehlercode/Nachricht Paaren sind, wird
1405                 <methodname>getErrors()</methodname> normalerweise nicht benötigt.
1406             </para>
1407         </note>
1408
1409         <para>
1410             Codes und Fehlermeldungen kann man für individuelle Elemente erhalten indem einfach
1411             der Name des Elements an jede übergeben wird:
1412         </para>
1413
1414         <programlisting language="php"><![CDATA[
1415 $codes = $form->getErrors('username');
1416 $messages = $form->getMessages('username');
1417 ]]></programlisting>
1418
1419         <note>
1420             <para>
1421                 Notiz: Wenn Elemente geprüft werden, sendet <classname>Zend_Form</classname> ein
1422                 zweites Argument zu jeder <methodname>isValid()</methodname> Methode der Elemente:
1423                 Das Array der Daten die geprüft werden sollen. Das kann von individuellen Prüfern
1424                 verwendet werden um Ihnen zu erlauben andere übertragene Werte zu verwenden wenn die
1425                 Gültigkeit der Daten ermittelt wird. Ein Beispiel wäre eine Registrations Form die
1426                 beide benötigt, ein Passwort und eine Passwort Bestätigung; das Passwort Element
1427                 könnte die Passwort Bestätigung als Teil seiner Prüfung verwenden.
1428             </para>
1429         </note>
1430
1431         <sect3 id="zend.form.forms.validation.errors">
1432             <title>Selbst definierte Fehlermeldungen</title>
1433
1434             <para>
1435                 Von Zeit zu Zeit ist es gewünscht ein oder mehrere spezielle Fehlermeldungen zu
1436                 spezifizieren die statt den Fehlermeldungen verwendet werden sollen die von den
1437                 Validatoren verwendet werden die dem Element angehängt sind. Zusätzlich will man von
1438                 Zeit zu Zeit ein Element selbst als ungültig markieren. Diese Funktionalität ist
1439                 über die folgenden Methoden ermöglicht.
1440             </para>
1441
1442             <itemizedlist>
1443                 <listitem>
1444                     <para>
1445                         <methodname>addErrorMessage($message)</methodname>: Fügt eine Fehlermeldung
1446                         hinzu die bei Form-Überprüfungs-Fehlern angezeigt wird. Sie kann mehr als
1447                         einmal aufgerufen werden, und neue Meldungen werden dem Stack angehängt.
1448                     </para>
1449                 </listitem>
1450
1451                 <listitem>
1452                     <para>
1453                         <methodname>addErrorMessages(array $messages)</methodname>: Fügt mehrere
1454                         Fehlermeldungen hinzu die bei Form-Überprüfungs-Fehlern angezeigt werden.
1455                     </para>
1456                 </listitem>
1457
1458                 <listitem>
1459                     <para>
1460                         <methodname>setErrorMessages(array $messages)</methodname>: Fügt mehrere
1461                         Fehlermeldungen hinzu die bei Form-Überprüfungs-Fehlern angezeigt werden,
1462                         und überschreibt alle vorher gesetzten Fehlermeldungen.
1463                     </para>
1464                 </listitem>
1465
1466                 <listitem>
1467                     <para>
1468                         <methodname>getErrorMessages()</methodname>: Empfängt eine Liste von
1469                         selbstdefinierten Fehlermeldungen die vorher definiert wurden.
1470                     </para>
1471                 </listitem>
1472
1473                 <listitem>
1474                     <para>
1475                         <methodname>clearErrorMessages()</methodname>: Entfernt alle eigenen
1476                         Fehlermeldungen die vorher definiert wurden.
1477                     </para>
1478                 </listitem>
1479
1480                 <listitem>
1481                     <para>
1482                         <methodname>markAsError()</methodname>: Markiert das Element wie wenn die
1483                         Überprüfung fehlgeschlagen wäre.
1484                     </para>
1485                 </listitem>
1486
1487                 <listitem>
1488                     <para>
1489                         <methodname>addError($message)</methodname>: Fügt einen Fehler zum eigenen
1490                         Stack der Fehlermeldungen hinzu und markiert das Element als ungültig.
1491                     </para>
1492                 </listitem>
1493
1494                 <listitem>
1495                     <para>
1496                         <methodname>addErrors(array $messages)</methodname>: Fügt mehrere
1497                         Nachrichten zum eigenen Stack der Fehlermeldungen hinzu und markiert das
1498                         Element als ungültig.
1499                     </para>
1500                 </listitem>
1501
1502                 <listitem>
1503                     <para>
1504                         <methodname>setErrors(array $messages)</methodname>: Überschreibt den
1505                         eigenen Stack der Fehlermeldungen mit den angegebenen Meldungen und markiert
1506                         das Element als ungültig.
1507                     </para>
1508                 </listitem>
1509             </itemizedlist>
1510
1511             <para>
1512                 Alle auf diesem Weg gesetzten Fehler können übersetzt werden.
1513             </para>
1514         </sect3>
1515
1516         <sect3 id="zend.form.forms.validation.values">
1517             <title>Nur einen gültigen Wert empfangen</title>
1518
1519             <para>
1520                 Es gibt Szenarien in denen man dem Benutzer erlauben will in verschiedenen Schritten
1521                 mit einem gültigen Formular zu arbeiten. In der Zwischenzeit wird dem Benutzer
1522                 erlaubt das Formular mit jedem Set an Werte zu speichern. Dann, wenn alle Daten
1523                 spezifiziert wurden kann das Modell von der Building oder Prototyping Stufe zu einer
1524                 Gültigen Stufe transferiert werden.
1525             </para>
1526
1527             <para>
1528                 Alle gültigen Werte die mit den übermittelten Daten übereinstimmen können empfangen
1529                 werden indem folgendes aufgerufen wird:
1530             </para>
1531
1532             <programlisting language="php"><![CDATA[
1533 $validValues = $form->getValidValues($_POST);
1534 ]]></programlisting>
1535         </sect3>
1536     </sect2>
1537
1538     <sect2 id="zend.form.forms.methods">
1539         <title>Methoden</title>
1540
1541         <para>
1542             Nachfolgend ist eine komplette Liste der in <classname>Zend_Form</classname> vorhandenen
1543             Methoden, gruppiert nach Typ:
1544         </para>
1545
1546         <itemizedlist>
1547             <listitem>
1548                 <para>Konfiguration und Optionen:</para>
1549
1550                 <itemizedlist>
1551                     <listitem>
1552                         <para><methodname>setOptions(array $options)</methodname></para>
1553                     </listitem>
1554
1555                     <listitem>
1556                         <para><methodname>setConfig(Zend_Config $config)</methodname></para>
1557                     </listitem>
1558                 </itemizedlist>
1559             </listitem>
1560
1561             <listitem>
1562                 <para>Plugin Loader und Pfade:</para>
1563
1564                 <itemizedlist>
1565                     <listitem>
1566                         <para>
1567                             <methodname>setPluginLoader(Zend_Loader_PluginLoader_Interface $loader,
1568                                 $type = null)</methodname>
1569                         </para>
1570                     </listitem>
1571
1572                     <listitem>
1573                         <para><methodname>getPluginLoader($type = null)</methodname></para>
1574                     </listitem>
1575
1576                     <listitem>
1577                         <para>
1578                             <methodname>addPrefixPath($prefix, $path, $type = null) </methodname>
1579                         </para>
1580                     </listitem>
1581
1582                     <listitem>
1583                         <para><methodname>addPrefixPaths(array $spec)</methodname></para>
1584                     </listitem>
1585
1586                     <listitem>
1587                         <para>
1588                             <methodname>addElementPrefixPath($prefix, $path, $type =
1589                                 null)</methodname>
1590                         </para>
1591                     </listitem>
1592
1593                     <listitem>
1594                         <para><methodname>addElementPrefixPaths(array $spec)</methodname></para>
1595                     </listitem>
1596
1597                     <listitem>
1598                         <para>
1599                             <methodname>addDisplayGroupPrefixPath($prefix, $path)</methodname>
1600                         </para>
1601                     </listitem>
1602                 </itemizedlist>
1603             </listitem>
1604
1605             <listitem>
1606                 <para>Metadaten:</para>
1607
1608                 <itemizedlist>
1609                     <listitem>
1610                         <para><methodname>setAttrib($key, $value)</methodname></para>
1611                     </listitem>
1612
1613                     <listitem>
1614                         <para><methodname>addAttribs(array $attribs)</methodname></para>
1615                     </listitem>
1616
1617                     <listitem>
1618                         <para><methodname>setAttribs(array $attribs)</methodname></para>
1619                     </listitem>
1620
1621                     <listitem><para><methodname>getAttrib($key)</methodname></para></listitem>
1622                     <listitem><para><methodname>getAttribs()</methodname></para></listitem>
1623                     <listitem><para><methodname>removeAttrib($key)</methodname></para></listitem>
1624                     <listitem><para><methodname>clearAttribs()</methodname></para></listitem>
1625                     <listitem><para><methodname>setAction($action)</methodname></para></listitem>
1626                     <listitem><para><methodname>getAction()</methodname></para></listitem>
1627                     <listitem><para><methodname>setMethod($method)</methodname></para></listitem>
1628                     <listitem><para><methodname>getMethod()</methodname></para></listitem>
1629                     <listitem><para><methodname>setName($name)</methodname></para></listitem>
1630                     <listitem><para><methodname>getName()</methodname></para></listitem>
1631                 </itemizedlist>
1632             </listitem>
1633
1634             <listitem>
1635                 <para>Elemente:</para>
1636
1637                 <itemizedlist>
1638                     <listitem>
1639                         <para>
1640                             <methodname>addElement($element, $name = null, $options =
1641                                 null)</methodname>
1642                         </para>
1643                     </listitem>
1644
1645                     <listitem>
1646                         <para><methodname>addElements(array $elements)</methodname></para>
1647                     </listitem>
1648
1649                     <listitem>
1650                         <para><methodname>setElements(array $elements)</methodname></para>
1651                     </listitem>
1652
1653                     <listitem><para><methodname>getElement($name)</methodname></para></listitem>
1654                     <listitem><para><methodname>getElements()</methodname></para></listitem>
1655                     <listitem><para><methodname>removeElement($name)</methodname></para></listitem>
1656                     <listitem><para><methodname>clearElements()</methodname></para></listitem>
1657
1658                     <listitem>
1659                         <para><methodname>setDefaults(array $defaults)</methodname></para>
1660                     </listitem>
1661
1662                     <listitem>
1663                         <para><methodname>setDefault($name, $value)</methodname></para>
1664                     </listitem>
1665
1666                     <listitem><para><methodname>getValue($name)</methodname></para></listitem>
1667                     <listitem><para><methodname>getValues()</methodname></para></listitem>
1668
1669                     <listitem>
1670                         <para><methodname>getUnfilteredValue($name)</methodname></para>
1671                     </listitem>
1672
1673                     <listitem><para><methodname>getUnfilteredValues()</methodname></para></listitem>
1674
1675                     <listitem>
1676                         <para><methodname>setElementFilters(array $filters)</methodname></para>
1677                     </listitem>
1678
1679                     <listitem>
1680                         <para>
1681                             <methodname>setElementDecorators(array $decorators)</methodname>
1682                         </para>
1683                     </listitem>
1684                 </itemizedlist>
1685             </listitem>
1686
1687             <listitem>
1688                 <para>Subformen:</para>
1689
1690                 <itemizedlist>
1691                     <listitem>
1692                         <para>
1693                             <methodname>addSubForm(Zend_Form $form, $name, $order =
1694                                 null)</methodname>
1695                         </para>
1696                     </listitem>
1697
1698                     <listitem>
1699                         <para><methodname>addSubForms(array $subForms)</methodname></para>
1700                     </listitem>
1701
1702                     <listitem>
1703                         <para><methodname>setSubForms(array $subForms)</methodname></para>
1704                     </listitem>
1705
1706                     <listitem><para><methodname>getSubForm($name)</methodname></para></listitem>
1707                     <listitem><para><methodname>getSubForms()</methodname></para></listitem>
1708                     <listitem><para><methodname>removeSubForm($name)</methodname></para></listitem>
1709                     <listitem><para><methodname>clearSubForms()</methodname></para></listitem>
1710
1711                     <listitem>
1712                         <para>
1713                             <methodname>setSubFormDecorators(array $decorators)</methodname>
1714                         </para>
1715                     </listitem>
1716                 </itemizedlist>
1717             </listitem>
1718
1719             <listitem>
1720                 <para>Anzeigegruppen:</para>
1721
1722                 <itemizedlist>
1723                     <listitem>
1724                         <para>
1725                             <methodname>addDisplayGroup(array $elements, $name, $options =
1726                                  null)</methodname>
1727                         </para>
1728                     </listitem>
1729
1730                     <listitem>
1731                         <para><methodname>addDisplayGroups(array $groups)</methodname></para>
1732                     </listitem>
1733
1734                     <listitem>
1735                         <para><methodname>setDisplayGroups(array $groups)</methodname></para>
1736                     </listitem>
1737
1738                     <listitem>
1739                         <para><methodname>getDisplayGroup($name)</methodname></para>
1740                     </listitem>
1741
1742                     <listitem><para><methodname>getDisplayGroups()</methodname></para></listitem>
1743
1744                     <listitem>
1745                         <para><methodname>removeDisplayGroup($name)</methodname></para>
1746                     </listitem>
1747
1748                     <listitem><para><methodname>clearDisplayGroups()</methodname></para></listitem>
1749
1750                     <listitem>
1751                         <para>
1752                             <methodname>setDisplayGroupDecorators(array $decorators)</methodname>
1753                         </para>
1754                     </listitem>
1755                 </itemizedlist>
1756             </listitem>
1757
1758             <listitem>
1759                 <para>Prüfungen</para>
1760
1761                 <itemizedlist>
1762                     <listitem>
1763                         <para><methodname>populate(array $values)</methodname></para>
1764                     </listitem>
1765
1766                     <listitem><para><methodname>isValid(array $data)</methodname></para></listitem>
1767
1768                     <listitem>
1769                         <para><methodname>isValidPartial(array $data)</methodname></para>
1770                     </listitem>
1771
1772                     <listitem>
1773                         <para><methodname>processAjax(array $data)</methodname></para>
1774                     </listitem>
1775
1776                     <listitem><para><methodname>persistData()</methodname></para></listitem>
1777
1778                     <listitem>
1779                         <para><methodname>getErrors($name = null)</methodname></para>
1780                     </listitem>
1781
1782                     <listitem>
1783                         <para><methodname>getMessages($name = null)</methodname></para>
1784                     </listitem>
1785                 </itemizedlist>
1786             </listitem>
1787
1788             <listitem>
1789                 <para>Darstellung:</para>
1790
1791                 <itemizedlist>
1792                     <listitem>
1793                         <para>
1794                             <methodname>setView(Zend_View_Interface $view = null)</methodname>
1795                         </para>
1796                     </listitem>
1797
1798                     <listitem><para><methodname>getView()</methodname></para></listitem>
1799
1800                     <listitem>
1801                         <para>
1802                             <methodname>addDecorator($decorator, $options = null)</methodname>
1803                         </para>
1804                     </listitem>
1805
1806                     <listitem>
1807                         <para><methodname>addDecorators(array $decorators)</methodname></para>
1808                     </listitem>
1809
1810                     <listitem>
1811                         <para><methodname>setDecorators(array $decorators)</methodname></para>
1812                     </listitem>
1813
1814                     <listitem><para><methodname>getDecorator($name)</methodname></para></listitem>
1815                     <listitem><para><methodname>getDecorators()</methodname></para></listitem>
1816
1817                     <listitem>
1818                         <para><methodname>removeDecorator($name)</methodname></para>
1819                     </listitem>
1820
1821                     <listitem><para><methodname>clearDecorators()</methodname></para></listitem>
1822
1823                     <listitem>
1824                         <para>
1825                             <methodname>render(Zend_View_Interface $view = null)</methodname>
1826                         </para>
1827                     </listitem>
1828                 </itemizedlist>
1829             </listitem>
1830
1831             <listitem>
1832                 <para>I18n:</para>
1833
1834                 <itemizedlist>
1835                     <listitem>
1836                         <para>
1837                             <methodname>setTranslator(Zend_Translate_Adapter $translator =
1838                                 null)</methodname>
1839                         </para>
1840                     </listitem>
1841
1842                     <listitem><para><methodname>getTranslator()</methodname></para></listitem>
1843
1844                     <listitem>
1845                         <para><methodname>setDisableTranslator($flag)</methodname></para>
1846                     </listitem>
1847
1848                     <listitem>
1849                         <para><methodname>translatorIsDisabled()</methodname></para>
1850                     </listitem>
1851                 </itemizedlist>
1852             </listitem>
1853         </itemizedlist>
1854     </sect2>
1855
1856     <sect2 id="zend.form.forms.config">
1857         <title>Konfiguration</title>
1858
1859         <para>
1860             <classname>Zend_Form</classname> ist über <methodname>setOptions()</methodname> und
1861             <methodname>setConfig()</methodname> vollständig konfigurierbar (oder durch die Übergabe
1862             von Optionen oder einem <classname>Zend_Config</classname> Objekt an den Konstruktor).
1863             Durch Verwendung dieser Methoden können Form Elemente, Anzeigegruppen, Dekoratore, und
1864             Metadaten spezifiziert werden.
1865         </para>
1866
1867         <para>
1868             Als generelle Regel, wenn 'set' + der Optionsschlüssel zu einer
1869             <classname>Zend_Form</classname> Methode referieren, wird der angebotene Wert zu dieser
1870             Methode übergeben. Wenn die Methode nicht existiert, wird angenommen das der Schlüssel
1871             eine Referenz zu einem Attribut ist, und wird an <methodname>setAttrib()</methodname>
1872             übergeben.
1873         </para>
1874
1875         <para>
1876             Ausnahmen zu dieser Regel sind die folgenden:
1877         </para>
1878
1879         <itemizedlist>
1880             <listitem>
1881                 <para>
1882                     <property>prefixPaths</property> wird übergeben an
1883                     <methodname>addPrefixPaths()</methodname>
1884                 </para>
1885             </listitem>
1886
1887             <listitem>
1888                 <para>
1889                     <property>elementPrefixPaths</property> wird übergeben an
1890                     <methodname>addElementPrefixPaths()</methodname>
1891                 </para>
1892             </listitem>
1893
1894             <listitem>
1895                 <para>
1896                     <property>displayGroupPrefixPaths</property> wird übergeben an
1897                     <methodname>addDisplayGroupPrefixPaths()</methodname>
1898                 </para>
1899             </listitem>
1900
1901             <listitem>
1902                 <para>die folgenden Setter können nicht auf diesem Weg gesetzt werden:</para>
1903
1904                 <itemizedlist>
1905                     <listitem>
1906                         <para>
1907                             <property>setAttrib</property> (da setAttribs *wird* funktionieren)
1908                         </para>
1909                     </listitem>
1910
1911                     <listitem><para><property>setConfig</property></para></listitem>
1912                     <listitem><para><property>setDefault</property></para></listitem>
1913                     <listitem><para><property>setOptions</property></para></listitem>
1914                     <listitem><para><property>setPluginLoader</property></para></listitem>
1915                     <listitem><para><property>setSubForms</property></para></listitem>
1916                     <listitem><para><property>setTranslator</property></para></listitem>
1917                     <listitem><para><property>setView</property></para></listitem>
1918                 </itemizedlist>
1919             </listitem>
1920         </itemizedlist>
1921
1922         <para>
1923             Als Beispiel ist hier eine Konfigurationsdatei die eine Konfiguration für jeden Typ
1924             von konfigurierbaren Daten übergibt:
1925         </para>
1926
1927         <programlisting language="ini"><![CDATA[
1928 [element]
1929 name = "Registrierung"
1930 action = "/user/register"
1931 method = "post"
1932 attribs.class = "zend_form"
1933 attribs.onclick = "validate(this)"
1934
1935 disableTranslator = 0
1936
1937 prefixPath.element.prefix = "My_Element"
1938 prefixPath.element.path = "My/Element/"
1939 elementPrefixPath.validate.prefix = "My_Validate"
1940 elementPrefixPath.validate.path = "My/Validate/"
1941 displayGroupPrefixPath.prefix = "My_Group"
1942 displayGroupPrefixPath.path = "My/Group/"
1943
1944 elements.username.type = "text"
1945 elements.username.options.label = "Benutzername"
1946 elements.username.options.validators.alpha.validator = "Alpha"
1947 elements.username.options.filters.lcase = "StringToLower"
1948 ; natürlich mehr Elemente...
1949
1950 elementFilters.trim = "StringTrim"
1951 ;elementDecorators.trim = "StringTrim"
1952
1953 displayGroups.login.elements.username = "username"
1954 displayGroups.login.elements.password = "password"
1955 displayGroupDecorators.elements.decorator = "FormElements"
1956 displayGroupDecorators.fieldset.decorator = "Fieldset"
1957
1958 decorators.elements.decorator = "FormElements"
1959 decorators.fieldset.decorator = "FieldSet"
1960 decorators.fieldset.decorator.options.class = "zend_form"
1961 decorators.form.decorator = "Form"
1962 ]]></programlisting>
1963
1964         <para>
1965             Das obige könnte einfach abstrahiert werden zu einer <acronym>XML</acronym> oder
1966             <acronym>PHP</acronym> Array-basierenden Konfigurations Datei.
1967         </para>
1968     </sect2>
1969
1970     <sect2 id="zend.form.forms.custom">
1971         <title>Eigene Forms</title>
1972
1973         <para>
1974             Eine Alternative zur Verwendung von Konfigurations-basierenden Forms ist es
1975             <classname>Zend_Form</classname> abzuleiten. Das hat einige Vorteile:
1976         </para>
1977
1978         <itemizedlist>
1979             <listitem>
1980                 <para>
1981                     Die Form kein einfachst mit Unittests getestet werden um sicherzugehen das
1982                     Prüfungen und Darstellungen wie erwartet durchgeführt werden.
1983                 </para>
1984             </listitem>
1985
1986             <listitem>
1987                 <para>Eine feinkörnige Kontrolle über individuelle Elemente.</para>
1988             </listitem>
1989
1990             <listitem>
1991                 <para>
1992                     Wiederverwendung von Form Objekten, und größere Portierbarkeit (keine
1993                     Notwendigkeit Konfigurationsdateien zu verfolgen).
1994                 </para>
1995             </listitem>
1996
1997             <listitem><para>Eigene Funktionalitäten zu implementieren.</para></listitem>
1998         </itemizedlist>
1999
2000         <para>
2001             Der typischste Anwendungsfall würde sein die <methodname>init()</methodname> Methode zu
2002             verwenden um spezielle Form Elemente und Konfigurationen zu definieren:
2003         </para>
2004
2005         <programlisting language="php"><![CDATA[
2006 class My_Form_Login extends Zend_Form
2007 {
2008     public function init()
2009     {
2010         $username = new Zend_Form_Element_Text('username');
2011         $username->class = 'formtext';
2012         $username->setLabel('Benutzername:')
2013                  ->setDecorators(array(
2014                      array('ViewHelper',
2015                            array('helper' => 'formText')),
2016                      array('Label',
2017                            array('class' => 'label'))
2018                  ));
2019
2020         $password = new Zend_Form_Element_Password('password');
2021         $password->class = 'formtext';
2022         $password->setLabel('Benutzername:')
2023                  ->setDecorators(array(
2024                      array('ViewHelper',
2025                            array('helper' => 'formPassword')),
2026                      array('Label',
2027                            array('class' => 'label'))
2028                  ));
2029
2030         $submit = new Zend_Form_Element_Submit('login');
2031         $submit->class = 'formsubmit';
2032         $submit->setValue('Anmeldung')
2033                ->setDecorators(array(
2034                    array('ViewHelper',
2035                    array('helper' => 'formSubmit'))
2036                ));
2037
2038         $this->addElements(array(
2039             $username,
2040             $password,
2041             $submit
2042         ));
2043
2044         $this->setDecorators(array(
2045             'FormElements',
2046             'Fieldset',
2047             'Form'
2048         ));
2049     }
2050 }
2051 ]]></programlisting>
2052
2053         <para>
2054             Diese form kann instanziert werden mit einem einfachen:
2055         </para>
2056
2057         <programlisting language="php"><![CDATA[
2058 $form = new My_Form_Login();
2059 ]]></programlisting>
2060
2061         <para>
2062             und die gesamte Funktionalität ist bereits eingestellt und bereit; keine
2063             Konfigurationsdateien notwendig. (Bitte beachten das dieses Beispiel sehr vereinfacht
2064             ist, da es keine Prüfungen oder Filter für die Elemente enthält.)
2065         </para>
2066
2067         <para>
2068             Ein anderer üblicher Grund für die Erweiterung ist es ein Set von Standard Dekoratoren
2069             zu definieren. Das kann durch überladen der
2070             <methodname>loadDefaultDecorators()</methodname> Methode durchgeführt werden:
2071         </para>
2072
2073         <programlisting language="php"><![CDATA[
2074 class My_Form_Login extends Zend_Form
2075 {
2076     public function loadDefaultDecorators()
2077     {
2078         $this->setDecorators(array(
2079             'FormElements',
2080             'Fieldset',
2081             'Form'
2082         ));
2083     }
2084 }
2085 ]]></programlisting>
2086     </sect2>
2087 </sect1>