vendor/symfony/form/FormView.php line 22

  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.  * @implements \ArrayAccess<int|string, FormView>
  20.  * @implements \IteratorAggregate<int|string, FormView>
  21.  */
  22. class FormView implements \ArrayAccess, \IteratorAggregate, \Countable
  23. {
  24.     /**
  25.      * The variables assigned to this view.
  26.      */
  27.     public $vars = [
  28.         'value' => null,
  29.         'attr' => [],
  30.     ];
  32.     /**
  33.      * The parent view.
  34.      */
  35.     public $parent;
  37.     /**
  38.      * The child views.
  39.      *
  40.      * @var array<int|string, FormView>
  41.      */
  42.     public $children = [];
  44.     /**
  45.      * Is the form attached to this renderer rendered?
  46.      *
  47.      * Rendering happens when either the widget or the row method was called.
  48.      * Row implicitly includes widget, however certain rendering mechanisms
  49.      * have to skip widget rendering when a row is rendered.
  50.      */
  51.     private bool $rendered = false;
  53.     private bool $methodRendered = false;
  55.     public function __construct(self $parent = null)
  56.     {
  57.         $this->parent = $parent;
  58.     }
  60.     /**
  61.      * Returns whether the view was already rendered.
  62.      */
  63.     public function isRendered(): bool
  64.     {
  65.         if (true === $this->rendered || 0 === \count($this->children)) {
  66.             return $this->rendered;
  67.         }
  69.         foreach ($this->children as $child) {
  70.             if (!$child->isRendered()) {
  71.                 return false;
  72.             }
  73.         }
  75.         return $this->rendered = true;
  76.     }
  78.     /**
  79.      * Marks the view as rendered.
  80.      *
  81.      * @return $this
  82.      */
  83.     public function setRendered(): static
  84.     {
  85.         $this->rendered = true;
  87.         return $this;
  88.     }
  90.     public function isMethodRendered(): bool
  91.     {
  92.         return $this->methodRendered;
  93.     }
  95.     /**
  96.      * @return void
  97.      */
  98.     public function setMethodRendered()
  99.     {
  100.         $this->methodRendered = true;
  101.     }
  103.     /**
  104.      * Returns a child by name (implements \ArrayAccess).
  105.      *
  106.      * @param int|string $name The child name
  107.      */
  108.     public function offsetGet(mixed $name): self
  109.     {
  110.         return $this->children[$name];
  111.     }
  113.     /**
  114.      * Returns whether the given child exists (implements \ArrayAccess).
  115.      *
  116.      * @param int|string $name The child name
  117.      */
  118.     public function offsetExists(mixed $name): bool
  119.     {
  120.         return isset($this->children[$name]);
  121.     }
  123.     /**
  124.      * Implements \ArrayAccess.
  125.      *
  126.      * @throws BadMethodCallException always as setting a child by name is not allowed
  127.      */
  128.     public function offsetSet(mixed $name, mixed $value): void
  129.     {
  130.         throw new BadMethodCallException('Not supported.');
  131.     }
  133.     /**
  134.      * Removes a child (implements \ArrayAccess).
  135.      *
  136.      * @param int|string $name The child name
  137.      */
  138.     public function offsetUnset(mixed $name): void
  139.     {
  140.         unset($this->children[$name]);
  141.     }
  143.     /**
  144.      * Returns an iterator to iterate over children (implements \IteratorAggregate).
  145.      *
  146.      * @return \ArrayIterator<int|string, FormView>
  147.      */
  148.     public function getIterator(): \ArrayIterator
  149.     {
  150.         return new \ArrayIterator($this->children);
  151.     }
  153.     public function count(): int
  154.     {
  155.         return \count($this->children);
  156.     }
  157. }