Home Info Files

Zend Framework 2 Documentation (Manual)

File: /_sources/modules/zend.form.view.helper.form-element.txt

:orphan:

.. _zend.form.view.helper.form-element:

FormElement
^^^^^^^^^^^

The ``FormElement`` view helper proxies the rendering to specific form view helpers
depending on the type of the ``Zend\Form\Element`` that is passed in. For instance,
if the passed in element had a type of "text", the ``FormElement`` helper will retrieve
and use the ``FormText`` helper to render the element.

Basic usage:

.. code-block:: php
   :linenos:

   use Zend\Form\Form;
   use Zend\Form\Element;

   // Within your view...

   /**
    * Example #1: Render different types of form elements
    */
   $textElement     = new Element\Text('my-text');
   $checkboxElement = new Element\Checkbox('my-checkbox');

   echo $this->formElement($textElement);
   // <input type="text" name="my-text" value="">

   echo $this->formElement($checkboxElement);
   // <input type="hidden" name="my-checkbox" value="0">
   // <input type="checkbox" name="my-checkbox" value="1">

   /**
    * Example #2: Loop through form elements and render them
    */
   $form = new Form();
   // ...add elements and input filter to form...
   $form->prepare();

   // Render the opening tag
   echo $this->form()->openTag($form);

   // ...loop through and render the form elements...
   foreach ($form as $element) {
       echo $this->formElement($element);       // <-- Magic!
       echo $this->formElementErrors($element);
   }

   // Render the closing tag
   echo $this->form()->closeTag();