symfony/src/Symfony/Bundle/TwigBundle/Extension/FormExtension.php

<?php

namespace Symfony\Bundle\TwigBundle\Extension;

use Symfony\Component\Form\Form;
use Symfony\Component\Form\FieldGroupInterface;
use Symfony\Component\Form\FieldInterface;
use Symfony\Bundle\TwigBundle\TokenParser\FormThemeTokenParser;
use Symfony\Bundle\FrameworkBundle\Templating\HtmlGeneratorInterface;

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien.potencier@symfony-project.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

/**
 *
 * @author Fabien Potencier <fabien.potencier@symfony-project.com>
 */
class FormExtension extends \Twig_Extension
{
    static protected $cache = array();

    protected $resources;
    protected $templates;
    protected $environment;
    protected $themes;
    protected $generator;

    public function __construct(HtmlGeneratorInterface $generator, array $resources = array())
    {
        $this->generator = $generator;
        $this->themes = new \SplObjectStorage();
        $this->resources = array_merge(array(
            'TwigBundle::form.twig',
            'TwigBundle::widgets.twig',
        ), $resources);
    }

    /**
     * {@inheritdoc}
     */
    public function initRuntime(\Twig_Environment $environment)
    {
        $this->environment = $environment;

        $this->templates = $this->resolveResources($this->resources);
    }

    public function setTheme(FieldGroupInterface $group, array $resources)
    {
        $this->themes->attach($group, $resources);
    }

    /**
     * Returns the token parser instance to add to the existing list.
     *
     * @return array An array of Twig_TokenParser instances
     */
    public function getTokenParsers()
    {
        return array(
            // {% form_theme form "SomeBungle::widgets.twig" %}
            new FormThemeTokenParser(),
        );
    }

    /**
     * {@inheritdoc}
     */
    public function getFilters()
    {
        return array(
            'render_enctype' => new \Twig_Filter_Method($this, 'renderEnctype', array('is_escaper' => true)),
            'render'         => new \Twig_Filter_Method($this, 'render', array('is_escaper' => true)),
            'render_hidden'  => new \Twig_Filter_Method($this, 'renderHidden', array('is_escaper' => true)),
            'render_errors'  => new \Twig_Filter_Method($this, 'renderErrors', array('is_escaper' => true)),
            'render_widget'  => new \Twig_Filter_Method($this, 'renderWidget', array('is_escaper' => true)),
            'render_label'   => new \Twig_Filter_Method($this, 'renderLabel', array('is_escaper' => true)),
            'render_data'    => new \Twig_Filter_Method($this, 'renderData', array('is_escaper' => true)),
            'render_choices' => new \Twig_Filter_Method($this, 'renderChoices', array('is_escaper' => true)),
        );
    }

    public function renderEnctype(Form $form)
    {
        return $form->isMultipart() ? 'enctype="multipart/form-data"' : '';
    }

    public function render(FieldInterface $field, array $attributes = array())
    {
        if ($field instanceof Form || get_class($field) === 'Symfony\Component\Form\FieldGroup') {
            return $this->templates['group']->getBlock('group', array(
                'group'      => $field,
                'attributes' => $attributes,
            ));
        }

        return $this->templates['field']->getBlock('field', array(
            'field'      => $field,
            'attributes' => $attributes,
        ));
    }

    public function renderHidden(FieldGroupInterface $form)
    {
        return $this->templates['hidden']->getBlock('hidden', array(
            'fields' => $form->getHiddenFields()
        ));
    }

    public function renderErrors($formOrField)
    {
        return $this->templates['errors']->getBlock('errors', array(
            'errors' => $formOrField->getErrors()
        ));
    }

    public function renderLabel(FieldInterface $field, $label = null, array $attributes = array())
    {
        return $this->templates['label']->getBlock('label', array(
            'id'         => $field->getId(),
            'key'        => $field->getKey(),
            'label'      => null !== $label ? $label : ucfirst(strtolower(str_replace('_', ' ', $field->getKey()))),
            'attributes' => $attributes,
        ));
    }

    public function renderWidget(FieldInterface $field, array $attributes = array(), $resources = null)
    {
        if (null === $resources) {
            $parent = $field;
            $resources = array();
            while ($parent = $parent->getParent()) {
                if (isset($this->themes[$parent])) {
                    $resources = $this->themes[$parent];
                }
            }
        } else {
            $resources = array($resources);
        }

        list($widget, $template) = $this->getWidget($field, $resources);

        return $template->getBlock($widget, array(
            'field'      => $field,
            'attributes' => array_merge($field->getAttributes(), $attributes),
        ));
    }

    public function renderData(FieldInterface $field)
    {
        return $field->getData();
    }

    public function renderChoices(FieldInterface $field)
    {
        return $this->generator->choices(
            $field->getPreferredChoices(),
            $field->getOtherChoices(),
            $field->getEmptyValue(),
            $field->getSelected()
        );
    }

    protected function getWidget(FieldInterface $field, array $resources = array())
    {
        $cacheable = true;
        $templates = array();
        if ($resources) {
            $templates = $this->resolveResources($resources);
            $cacheable = false;
        }

        // add "global" templates as fallback
        $templates = array_merge($this->templates, $templates);

        $class = get_class($field);

        if (true === $cacheable && isset(self::$cache[$class])) {
            return self::$cache[$class];
        }

        // find a template for the given class or one of its parents
        do {
            $parts = explode('\\', $class);
            $c = array_pop($parts);

            $underscore = strtolower(preg_replace(array('/([A-Z]+)([A-Z][a-z])/', '/([a-z\d])([A-Z])/'), array('\\1_\\2', '\\1_\\2'), strtr($c, '_', '.')));

            if (isset($templates[$underscore])) {
                if (true === $cacheable) {
                    self::$cache[$class] = array($underscore, $templates[$underscore]);
                }

                return array($underscore, $templates[$underscore]);
            }
        } while (false !== $class = get_parent_class($class));

        throw new \RuntimeException(sprintf('Unable to render the "%s" field.', $field->getKey()));
    }

    protected function resolveResources(array $resources)
    {
        $templates = array();
        foreach ($resources as $resource)
        {
            $blocks = $this->resolveTemplate($this->environment->loadTemplate($resource));

            $templates = array_replace($templates, $blocks);
        }

        return $templates;
    }

    protected function resolveTemplate($template)
    {
        // an array of blockName => template
        $blocks = array();
        foreach ($template->getBlockNames() as $name) {
            $blocks[$name] = $template;
        }

        return $blocks;
    }

    /**
     * Returns the name of the extension.
     *
     * @return string The extension name
     */
    public function getName()
    {
        return 'form';
    }
}