DesignPatternsPHP/Composite/Form.php

<?php

namespace DesignPatterns\Composite;

/**
 * composite pattern
 *
 * Purpose:
 * to treat a group of objects the same way as a single instance of the object
 *
 * Example:
 * - a form class instance handles all its form elements like a single instance of the form, when render() is called, it
 *      subsequently runs trough all its child elements and calls render() on them
 * - Zend_Config: a tree of configuration options, each one is a Zend_Config object
 *
 * The composite node MUST extend the component contract. This is mandatory for building
 * a tree of component.
 */
class Form extends FormElement
{
    protected $_elements;

    /**
     * runs through all elements and calls render() on them, then returns the complete representation
     * of the form
     *
     * from the outside, one will not see this and the form will act like a single object instance
     *
     * @return string
     */
    public function render()
    {
        $formCode = '';
        foreach ($this->_elements as $element) {
            $formCode .= $element->render();
        }

        return $formCode;
    }

    public function addElement(FormElement $element)
    {
        $this->_elements[] = $element;
    }
}