Permalink
Browse files

feature #4411 Added a reference to the Bootstrap 3 form theme (javier…

…eguiluz)

This PR was submitted for the master branch but it was merged into the 2.6 branch instead (closes #4411).

Discussion
----------

Added a reference to the Bootstrap 3 form theme

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes
| Applies to    | 2.6+
| Fixed tickets | #4296

Commits
-------

c85a8ac Added a reference to the Bootstrap 3 form theme
  • Loading branch information...
weaverryan committed Nov 20, 2014
2 parents f8226e2 + c85a8ac commit ed5c61faa37e06aa6c21b8036ecb32403b1b846c
Showing with 16 additions and 3 deletions.
  1. +16 −3 cookbook/form/form_customization.rst
@@ -93,9 +93,18 @@ rendering a form. In other words, if you want to customize one portion of
how a form is rendered, you'll import a *theme* which contains a customization
of the appropriate form fragments.
Symfony comes with a default theme (`form_div_layout.html.twig`_ in Twig and
``FrameworkBundle:Form`` in PHP) that defines each and every fragment needed
to render every part of a form.
Symfony comes with four **built-in form themes** that define each and every
fragment needed to render every part of a form:
* `form_div_layout.html.twig`_, wraps each form field inside a ``<div>`` element.
* `form_table_layout.html.twig`_, wraps the entire form inside a ``<table>``
element and each form field inside a ``<tr>`` element.
* `bootstrap_3_layout.html.twig`_, wraps each form field inside a ``<div>`` element
with the appropriate CSS classes to apply the default `Bootstrap 3 CSS framework`_
styles.
* `bootstrap_3_horizontal_layout.html.twig`_, it's similar to the previous theme,
but the CSS classes applied are the ones used to display the forms horizontally
(i.e. the label and the widget in the same row).
In the next section you will learn how to customize a theme by overriding
some or all of its fragments.
@@ -1059,3 +1068,7 @@ The array passed as the second argument contains form "variables". For
more details about this concept in Twig, see :ref:`twig-reference-form-variables`.
.. _`form_div_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/form_div_layout.html.twig
.. _`form_table_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/form_table_layout.html.twig
.. _`bootstrap_3_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_3_layout.html.twig
.. _`bootstrap_3_horizontal_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_3_horizontal_layout.html.twig
.. _`Bootstrap 3 CSS framework`: http://getbootstrap.com/

0 comments on commit ed5c61f

Please sign in to comment.