On this page
Laminas\Form\View\Helper\FormCollection was originally developed for rendering
Laminas\Form\Element\Collection instances, but is capable of rendering any
iterable element type, including fieldsets and forms.
Internally, it iterates the element provided, and calls one of the following view helpers based on the element encountered:
- If a fieldset (or, by extension, collection or form) is encountered, it is
passed to itself (in other words,
- Otherwise, it is passed to FormRow.
use My\ContactFieldset; use Laminas\Form\Element; $collection = new Element\Collection(); $collection->setName('contacts'); $collection->setShouldCreateTemplate(true); $collection->setAllowAdd(true); $collection->setTargetElement([ 'type' => ContactFieldset::class ]); // In a view script: echo $this->formCollection($collection);
The above, assuming the fieldset is created correctly, will generate one or more
fieldsets with the name
contacts, each containing the elements defined in
My\ContactFieldset. The number of fieldsets created will be based on what data
was bound to the form.
By default, the collection is wrapped into
<fieldset> tag. You can override
this behavior passing
false as second parameter of the helper.
You can also prevent fieldset addition using
// In a view script // Both following lines are equivalent: echo $this->formCollection($collection, false); echo $this->formCollection($collection)->setShouldWrap(false);
Found a mistake or want to contribute to the documentation? Edit this page on GitHub!