minor #10126 Improve the docs about custom form theme config (javiereguiluz)

javiereguiluz · javiereguiluz · commit 225ba4101e89 · 2018-07-30T15:17:03.000+02:00
This PR was merged into the 2.8 branch. Discussion ---------- Improve the docs about custom form theme config Related to symfony/symfony#26879 Commits ------- 0c624b5 Improve the docs about custom form theme config
diff --git a/form/form_themes.rst b/form/form_themes.rst
@@ -179,6 +179,7 @@ file:
         # app/config/config.yml
         twig:
             form_themes:
+                - '...'
                 - 'form/fields.html.twig'
             # ...
 
@@ -194,6 +195,7 @@ file:
                 http://symfony.com/schema/dic/twig http://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
             <twig:config>
+                <twig:theme>...</twig:theme>
                 <twig:theme>form/fields.html.twig</twig:theme>
                 <!-- ... -->
             </twig:config>
@@ -204,11 +206,17 @@ file:
         // app/config/config.php
         $container->loadFromExtension('twig', array(
             'form_themes' => array(
+                '...',
                 'form/fields.html.twig',
             ),
             // ...
         ));
 
+.. note::
+
+    Add your custom theme at the end of the ``form_themes`` list because each
+    theme overrides all the previous themes.
+
 Any blocks inside the ``fields.html.twig`` template are now used globally
 to define form output.
 
