vendor/symfony/form/FormView.php line 19

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <[email protected]>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Form;
  14. use Symfony\Component\Form\Exception\BadMethodCallException;
  16. /**
  17.  * @author Bernhard Schussek <[email protected]>
  18.  */
  19. class FormView implements \ArrayAccess, \IteratorAggregate, \Countable
  20. {
  21.     /**
  22.      * The variables assigned to this view.
  23.      */
  24.     public $vars = [
  25.         'value' => null,
  26.         'attr' => [],
  27.     ];
  29.     /**
  30.      * The parent view.
  31.      */
  32.     public $parent;
  34.     /**
  35.      * The child views.
  36.      *
  37.      * @var FormView[]
  38.      */
  39.     public $children = [];
  41.     /**
  42.      * Is the form attached to this renderer rendered?
  43.      *
  44.      * Rendering happens when either the widget or the row method was called.
  45.      * Row implicitly includes widget, however certain rendering mechanisms
  46.      * have to skip widget rendering when a row is rendered.
  47.      *
  48.      * @var bool
  49.      */
  50.     private $rendered = false;
  52.     private $methodRendered = false;
  54.     public function __construct(self $parent = null)
  55.     {
  56.         $this->parent = $parent;
  57.     }
  59.     /**
  60.      * Returns whether the view was already rendered.
  61.      *
  62.      * @return bool Whether this view's widget is rendered
  63.      */
  64.     public function isRendered()
  65.     {
  66.         if (true === $this->rendered || 0 === \count($this->children)) {
  67.             return $this->rendered;
  68.         }
  70.         foreach ($this->children as $child) {
  71.             if (!$child->isRendered()) {
  72.                 return false;
  73.             }
  74.         }
  76.         return $this->rendered = true;
  77.     }
  79.     /**
  80.      * Marks the view as rendered.
  81.      *
  82.      * @return $this
  83.      */
  84.     public function setRendered()
  85.     {
  86.         $this->rendered = true;
  88.         return $this;
  89.     }
  91.     /**
  92.      * @return bool
  93.      */
  94.     public function isMethodRendered()
  95.     {
  96.         return $this->methodRendered;
  97.     }
  99.     public function setMethodRendered()
  100.     {
  101.         $this->methodRendered = true;
  102.     }
  104.     /**
  105.      * Returns a child by name (implements \ArrayAccess).
  106.      *
  107.      * @param string $name The child name
  108.      *
  109.      * @return self The child view
  110.      */
  111.     public function offsetGet($name)
  112.     {
  113.         return $this->children[$name];
  114.     }
  116.     /**
  117.      * Returns whether the given child exists (implements \ArrayAccess).
  118.      *
  119.      * @param string $name The child name
  120.      *
  121.      * @return bool Whether the child view exists
  122.      */
  123.     public function offsetExists($name)
  124.     {
  125.         return isset($this->children[$name]);
  126.     }
  128.     /**
  129.      * Implements \ArrayAccess.
  130.      *
  131.      * @throws BadMethodCallException always as setting a child by name is not allowed
  132.      */
  133.     public function offsetSet($name, $value)
  134.     {
  135.         throw new BadMethodCallException('Not supported');
  136.     }
  138.     /**
  139.      * Removes a child (implements \ArrayAccess).
  140.      *
  141.      * @param string $name The child name
  142.      */
  143.     public function offsetUnset($name)
  144.     {
  145.         unset($this->children[$name]);
  146.     }
  148.     /**
  149.      * Returns an iterator to iterate over children (implements \IteratorAggregate).
  150.      *
  151.      * @return \ArrayIterator|FormView[] The iterator
  152.      */
  153.     public function getIterator()
  154.     {
  155.         return new \ArrayIterator($this->children);
  156.     }
  158.     /**
  159.      * Implements \Countable.
  160.      *
  161.      * @return int The number of children views
  162.      */
  163.     public function count()
  164.     {
  165.         return \count($this->children);
  166.     }
  167. }