form(form_view, variables)

Отображает HTML полной формы.

1
2

{# отобразить форму и изменить метод отправки #}
{{ form(form, {'method': 'GET'}) }}

Вы в основном будете использовать этого помощника для прототипов, или если вы используете пользовательские темы формы. Если вам нужно больше гибкости в отображении формы, вам лучше стоит использовать другие помощники для отображения отдельных частей формы:

1
2
3
4
5
6
7
8

{{ form_start(form) }}
    {{ form_errors(form) }}

    {{ form_row(form.name) }}
    {{ form_row(form.dueDate) }}

    {{ form_row(form.submit, { 'label': 'Submit me' }) }}
{{ form_end(form) }}

form_start(form_view, variables)

Отображает стартовый тег формы. Этот помощник заботится о выводе сконфигурированного метода и целевого действия формы. Он также добавит правильное свойство enctype, если форма содержит поля загрузки.

1
2

{# отобразить стартовый тег и изменить метод отправки #}
{{ form_start(form, {'method': 'GET'}) }}

form_end(form_view, variables)

Отображает конечный тег формы.

1

{{ form_end(form) }}

Этот помощний также выводит form_rest() (что объясняется позже в этой статье), кроме случаев, когда вы устанавливаете render_rest как false:

1
2

{# не отображать неотображаемые поля #}
{{ form_end(form, {render_rest: false}) }}

form_label(form_view, label, variables)

Отображает ярлык для заданного поля. Вы можете по желанию передать определенный ярлык, который вы хотите отобразить в качестве второго аргумента.

1
2
3
4
5
6
7
8
9

{{ form_label(form.name) }}

{# Два следующих синтаксиса эквивалентны #}
{{ form_label(form.name, 'Your Name', {'label_attr': {'class': 'foo'}}) }}

{{ form_label(form.name, null, {
    'label': 'Your name',
    'label_attr': {'class': 'foo'}
}) }}

См. "Справочник функций и переменных форм шаблонов Twig", чтобы узнать об аргументе variables.

form_help(form_view)

Отображает текст помощи для заданного поля.

1

{{ form_help(form.name) }}

form_errors(form_view)

Отображает любые ошибки для заданного поля.

1
2
3
4
5

{# отобразить только сообщения об ошибках, cвязанных с этим полем #}
{{ form_errors(form.name) }}

{# отобразить любые "глобальные" ошибки, н связанные ни с каким полем формы #}
{{ form_errors(form) }}

form_widget(form_view, variables)

Отображает HTML-виджет заданного поля. Если вы примените это ко всей форме или коллекции полей, каждая низлежащая строка формы будет отображена.

1
2

{# отобразить виджет, но добавить к нему класс "foo" #}
{{ form_widget(form.name, {'attr': {'class': 'foo'}}) }}

Второй аргументform_widget() - это массив переменных. Наиболее распространенной переменной является attr, которая представляет собой массив HTML-атрибутов, применяемых к HTML-виджету. В некоторых случаях, определенные типы также имеют другие опции, связанные с шаблонами, которые можно передать. Они обсуждаются на основании каждого типа. attributes не применяются рекурсивно к дочерним полям, если вы отображете несколько полей сразу (например, form_widget(form)).

См. "Справочник функций и переменных форм шаблонов Twig", чтобы узнать больше об аргументе variables.

form_row(form_view, variables)

Отображает "строку" заданного поля, которая является комбинацией ярлыка, ошибок, помощи и виджета поля.

1
2

{# отобразить строку поля, но отобразить ярлык с текстом "foo" #}
{{ form_row(form.name, {'label': 'foo'}) }}

Второй аргумент form_row() - это массив переменных. Шаблоны, предоставленные Symfony позволяют переопределять ярлык только так, как показано в примере выше.

См. "Справочник функций и переменных форм шаблонов Twig", чтобы узнать об аргументе variables.

form_rest(form_view, variables)

Это отображает все поля, которые еще не были отображены для заданной формы. Хорошей идеей будет всегда иметь эту функцию где-то внутри вашей формы, так как она будет отображать для вас спрятанные поля, и облегчит обнаружение полей, которые вы забыли отобразить (так как она будет отображать поле для вас).

1

{{ form_rest(form) }}

form_parent(form_view)

Возвращает просмотр родительской формы или null, если просмотр формы уже является начальной формой. Исползование этой функции должно быть в приоритете над доступом к родительской форме с использованием form.parent. Последнее будет производить разные результаты, если дочерняя форма называется parent.

selectedchoice(selected_value)

Этот тест проверит равен ли текущий выбор selected_value или находится ли текущий выбор в массиве (когда selected_value является массивом).

1

<option {% if choice is selectedchoice(value) %}selected="selected"{% endif %}>

rootform

Этот тест проверит, имеет ли текущий form родительский просмотр формы.

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{# НЕ ДЕЛАЙТЕ ТАК: эта простая проверка не видит различий между формой,
    имеющей родительский просмотр формы, и формой, определяющей встроенное
    поле формы под названием 'parent' #}

 {% if form.parent is null %}
     {{ form_errors(form) }}
 {% endif %}

{# ДЕЛАЙТЕ ТАК: на эту проверку всегда можно положиться, даже если форма определяет
   поле под названием 'parent' #}

 {% if form is rootform %}
     {{ form_errors(form) }}
 {% endif %}