{% form_theme form.a_child_form 'form/fields_child.html.twig' %}

Form Theming in PHP

.. _referencing-base-form-blocks-twig-specific:

When using PHP as a templating engine, the only method to customize a fragment

is to create a new template file - this is similar to the second method used by

Twig.

The template file must be named after the fragment. You must create a ``integer_widget.html.php``

file in order to customize the ``integer_widget`` fragment.

..code-block::html+php

<!-- src/Resources/integer_widget.html.php -->

<div class="integer_widget">

<?php echo $view['form']->block(

$form,

'form_widget_simple',

array('type' => isset($type) ? $type : "number")

) ?>

</div>

Now that you've created the customized form template, you need to tell Symfony

to use it. Inside the template where you're actually rendering your form,

tell Symfony to use the theme via the ``setTheme()`` helper method::

When the ``form.age`` widget is rendered, Symfony will use the customized

``integer_widget.html.php`` template and the ``input`` tag will be wrapped in

the ``div`` element.

If you want to apply a theme to a specific child form, pass it to the ``setTheme()``

method::

..note::

The ``:form`` syntax is based on the functional names for templates:

``Bundle:Directory``. As the form directory lives in the

``templates/`` directory, the ``Bundle`` part is empty, resulting

in ``:form``.

Referencing base Form Blocks (Twig specific)

Referencing base Form Blocks

So far, to override a particular form block, the best method is to copy

the default block from `form_div_layout.html.twig`_, paste it into a different template,

templating engine. You have to manually copy the content from the base block

to your new template file.

.. _twig:

Making Application-wide Customizations

If you'd like a certain form customization to be global to your application,

you can accomplish this by making the form customizations in an external

template and then importing it inside your application configuration.

Twig

By using the following configuration, any customized form blocks inside the

``form/fields.html.twig`` template will be used globally when a form is

rendered.

Note that the ``form`` variable in the above code is the form view variable

that you passed to your template.

PHP

By using the following configuration, any customized form fragments inside the

``templates/form`` folder will be used globally when a

form is rendered.

..configuration-block::

..code-block::yaml

..code-block::xml

..code-block::php

By default, the PHP engine uses a *div* layout when rendering forms. Some people,

however, may prefer to render forms in a *table* layout. Use the ``FrameworkBundle:FormTable``

resource to use such a layout:

..configuration-block::

..code-block::yaml

..code-block::xml

..code-block::php

If you only want to make the change in one template, add the following line to

your template file rather than adding the template as a resource:

..code-block::html+php

<?php $view['form']->setTheme($form, array('FrameworkBundle:FormTable')); ?>

Note that the ``$form`` variable in the above code is the form view variable

that you passed to your template.

How to Customize an individual Field

If you want to denote all of your required fields with a required asterisk (``*``),

you can do this by customizing the ``form_label`` fragment.

In Twig, if you're making the form customization inside the same template as your

If you're making the form customization inside the same template as your

form, modify the ``use`` tag and add the following:

..code-block::html+twig

{% endif %}

{% endblock %}

In Twig, if you're making the form customization inside a separate template, use

If you're making the form customization inside a separate template, use

the following:

..code-block::html+twig

{% endif %}

{% endblock %}

When using PHP as a templating engine you have to copy the content from the

original template:

..code-block::html+php

<!-- form_label.html.php -->

<!-- original content -->

<?php if ($required) { $label_attr['class'] = trim((isset($label_attr['class']) ? $label_attr['class'] : '').' required'); } ?>

<?php if (!$compound) { $label_attr['for'] = $id; } ?>

<?php if (!$label) { $label = $view['form']->humanize($name); } ?>

<label <?php foreach ($label_attr as $k => $v) { printf('%s="%s" ', $view->escape($k), $view->escape($v)); } ?>><?php echo $view->escape($view['translator']->trans($label, array(), $translation_domain)) ?></label>

<!-- customization -->

<?php if ($required) : ?>

<span class="required" title="This field is required">*</span>

<?php endif ?>

..tip::

See:ref:`form-theming-methods` for how to apply this customization.

You can also customize your form widgets to have an optional "help" message.

In Twig, if you're making the form customization inside the same template as your

If you're making the form customization inside the same template as your

form, modify the ``use`` tag and add the following:

..code-block::html+twig

{% endif %}

{% endblock %}

In Twig, if you're making the form customization inside a separate template, use

If you're making the form customization inside a separate template, use

the following:

..code-block::html+twig

{% endif %}

{% endblock %}

When using PHP as a templating engine you have to copy the content from the

original template:

..code-block::html+php

<!-- form_widget_simple.html.php -->

<!-- Original content -->

<input

type="<?php echo isset($type) ? $view->escape($type) : 'text' ?>"

<?php if (!empty($value)): ?>value="<?php echo $view->escape($value) ?>"<?php endif ?>

<?php echo $view['form']->block($form, 'widget_attributes') ?>

/>

<!-- Customization -->

<?php if (isset($help)) : ?>

<span class="help"><?php echo $view->escape($help) ?></span>

<?php endif ?>

To render a help message below a field, pass in a ``help`` variable:

..code-block::twig