Form Tests Reference

Tests can be executed by using the ``is`` operator in Twig to create a

condition. Read `the Twig documentation`_ for more information.

.. _form-twig-selectedchoice:

selectedchoice(selected_value)

This test will check if the current choice is equal to the ``selected_value``

or if the current choice is in the array (when ``selected_value`` is an array).

.. code-block:: jinja

.. versionadded:: 2.3

The ``method`` and ``action`` variables were introduced in Symfony 2.3.

| Variable | Usage |

| ``form`` | The current ``FormView`` instance. |

| ``id`` | The ``id`` HTML attribute to be rendered. |

| ``name`` | The name of the field (e.g. ``title``) - but not the ``name`` |

| | HTML attribute, which is ``full_name``. |

| ``full_name`` | The ``name`` HTML attribute to be rendered. |

| ``errors`` | An array of any errors attached to *this* specific field |

| | (e.g. ``form.title.errors``). |

| | Note that you can't use ``form.errors`` to determine if a form is valid, |

| | since this only returns "global" errors: some individual fields may have errors. |

| | Instead, use the ``valid`` option. |

| ``valid`` | Returns ``true`` or ``false`` depending on whether the whole form is valid. |

| ``value`` | The value that will be used when rendering (commonly the ``value`` HTML attribute). |

| ``read_only`` | If ``true``, ``readonly="readonly"`` is added to the field. |

| ``disabled`` | If ``true``, ``disabled="disabled"`` is added to the field. |

| ``required`` | If ``true``, a ``required`` attribute is added to the field to activate HTML5 |

| | validation. Additionally, a ``required`` class is added to the label. |

| ``max_length`` | Adds a ``maxlength`` HTML attribute to the element. |

| ``pattern`` | Adds a ``pattern`` HTML attribute to the element. |

| ``label`` | The string label that will be rendered. |

| ``multipart`` | If ``true``, ``form_enctype`` will render ``enctype="multipart/form-data"``. |

| | This only applies to the root form element. |

| ``attr`` | A key-value array that will be rendered as HTML attributes on the field. |

| ``label_attr`` | A key-value array that will be rendered as HTML attributes on the label. |

| ``compound`` | Whether or not a field is actually a holder for a group of children fields |

| | (for example, a ``choice`` field, which is actually a group of checkboxes. |

| ``block_prefixes`` | An array of all the names of the parent types. |

| ``translation_domain`` | The domain of the translations for this form. |

| ``cache_key`` | A unique key which is used for caching. |

| ``data`` | The normalized data of the type. |

| ``method`` | The method of the current form (POST, GET, etc.). |

| ``action`` | The action of the current form. |

.. _`the Twig documentation`: http://twig.sensiolabs.org/doc/templates.html#test-operator