Added a note about customizing a form with more than one template

javiereguiluz · javiereguiluz · commit 2b0213b365f2 · 2014-05-26T13:26:44.000+02:00
diff --git a/cookbook/form/form_customization.rst b/cookbook/form/form_customization.rst
@@ -298,6 +298,33 @@ When the ``form.age`` widget is rendered, Symfony will use the ``integer_widget`
 block from the new template and the ``input`` tag will be wrapped in the
 ``div`` element specified in the customized block.
 
+Multiple templates
+..................
+
+A form can also be customized applying several templates. To do so, pass the
+name of all the templates to the ``form_theme`` tag separating them with one
+whitespace:
+
+.. code-block:: html+jinja
+
+    {% form_theme form '::common.html.twig' ':Form:fields.html.twig'
+                       'AcmeDemoBundle:Form:fields.html.twig' %}
+
+    {# ... #}
+
+The templates can be located at different bundles and they can even be stored
+at the global ``app/Resources/views/`` directory.
+
+When using the ``with`` keyword, pass the templates as an array:
+
+
+.. code-block:: html+jinja
+
+    {% form_theme form with ['::common.html.twig', ':Form:fields.html.twig',
+                       'AcmeDemoBundle:Form:fields.html.twig'] %}
+
+    {# ... #}
+
 Child Forms
 ...........
 
