From 8d45f8343f210b2e38449af6ba7d9dc5c1140e77 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edi=20Modri=C4=87?= Date: Tue, 2 May 2017 13:14:22 +0200 Subject: [PATCH 1/2] Document disabling the usage of globally defined form themes --- form/form_customization.rst | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/form/form_customization.rst b/form/form_customization.rst index 1ed087a32d6..9ce03d29b35 100644 --- a/form/form_customization.rst +++ b/form/form_customization.rst @@ -336,6 +336,37 @@ name of all the templates as an array using the ``with`` keyword: The templates can also be located in different bundles, use the Twig namespaced path to reference these templates, e.g. ``@AcmeFormExtra/form/fields.html.twig``. +Disabling usage of globally defined themes +.......................................... + +Sometimes it is useful to disable usage of globally defined form themes in order +to have more control over rendering of a form. You might want this, for example, +when creating admin interface for a bundle which can be installed on a wide range +of Symfony apps and you can't control what themes are defined globally. + +You can do this by including the ``only`` keyword after the list of used form +themes: + +.. code-block:: html+twig + + {% form_theme form with ['common.html.twig', 'form/fields.html.twig'] only %} + + {# ... #} + +.. caution:: + + When using the ``only`` keyword, form themes shipped with Symfony + (``form_div_layout.html.twig`` and others) will not be used, so to render your + forms correcly, you need to either provide the base form theme yourself, or + ``use`` one of the built in form themes from your own theme: + + .. code-block:: html+twig + + {# app/Resources/views/common.html.twig #} + {% use "form_div_layout.html.twig" %} + + {# ... #} + Child Forms ........... From 14ef7ae628f762433c17bafe8c7b94682a765669 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Sun, 29 Oct 2017 19:55:46 +0100 Subject: [PATCH 2/2] Minor reword --- form/form_customization.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/form/form_customization.rst b/form/form_customization.rst index 9ce03d29b35..ec92c3fd1ff 100644 --- a/form/form_customization.rst +++ b/form/form_customization.rst @@ -355,10 +355,11 @@ themes: .. caution:: - When using the ``only`` keyword, form themes shipped with Symfony - (``form_div_layout.html.twig`` and others) will not be used, so to render your - forms correcly, you need to either provide the base form theme yourself, or - ``use`` one of the built in form themes from your own theme: + When using the ``only`` keyword, none of Symfony's built-in form themes + (``form_div_layout.html.twig``, etc.) will be applied. In order to render + your forms correctly, you need to either provide a full-featured form theme + yourself, or extend one of the built-in form themes with Twig's ``use`` + keyword instead of ``extends`` to reuse the original theme contents. .. code-block:: html+twig