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 <fabien@symfony.com>
  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 <bschussek@gmail.com>
  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.      * @return void
  132.      *
  133.      * @throws BadMethodCallException always as setting a child by name is not allowed
  134.      */
  135.     public function offsetSet($name, $value)
  136.     {
  137.         throw new BadMethodCallException('Not supported.');
  138.     }
  140.     /**
  141.      * Removes a child (implements \ArrayAccess).
  142.      *
  143.      * @param string $name The child name
  144.      *
  145.      * @return void
  146.      */
  147.     public function offsetUnset($name)
  148.     {
  149.         unset($this->children[$name]);
  150.     }
  152.     /**
  153.      * Returns an iterator to iterate over children (implements \IteratorAggregate).
  154.      *
  155.      * @return \ArrayIterator<string, FormView> The iterator
  156.      */
  157.     public function getIterator()
  158.     {
  159.         return new \ArrayIterator($this->children);
  160.     }
  162.     /**
  163.      * Implements \Countable.
  164.      *
  165.      * @return int The number of children views
  166.      */
  167.     public function count()
  168.     {
  169.         return \count($this->children);
  170.     }
  171. }