Функции отображения формы

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

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(view, variables)

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

1
2

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

form_end(view, variables)

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

1

{{ form_end(form) }}

Этот помощник также выводит form_rest(), разве что вы не установите render_rest, как "false":

1
2

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

form_label(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_errors(view)

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

1
2
3
4

{{ form_errors(form.name) }}

{# отобразить любые "глобальные" ошибки #}
{{ form_errors(form) }}

form_widget(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(view, variables)

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

1
2

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

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

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

form_rest(view, variables)

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

1

{{ form_rest(form) }}

Справочник тестов форм

Тесты могут быть выполнены с использованием оператора is в Twig, чтобы создать условие. Прочтите документацию Twig, чтобы узнать больше.

1

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

Больше о переменных форм

Почти в каждой функции Twig выше, финальный аргумент - это массив "переменных", используемых при отображении одной части формы. Например,следующее будет отображать "виджет" для поля и изменять его атрибуты, чтобы включать специальный класс:

1
2

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

Цель этих переменных - что они делают и откуда они берутся - может быть ясна не сразу, но они очень мощные. Каждый раз, когда вы отображаете часть вашей формы, блок, отображающий её, использует несколько переменных. По умолчанию, эти блоки живут внутри form_div_layout.html.twig.

Рассмотрите form_label в качестве примера:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

{% block form_label %}
    {% if not compound %}
        {% set label_attr = label_attr|merge({'for': id}) %}
    {% endif %}

    {% if required %}
        {% set label_attr = label_attr|merge({
            'class': (label_attr.class|default('') ~ ' required')|trim
        }) %}
    {% endif %}

    {% if label is empty %}
        {% set label = name|humanize %}
    {% endif %}

    <label
        {% for attrname, attrvalue in label_attr -%}
            {{ attrname }}="{{ attrvalue }}"
        {%- endfor %}
    >
        {{ label|trans({}, translation_domain) }}
    </label>
{% endblock form_label %}

Этот блок использует несколько переменных: compound, label_attr, required, label, name и translation_domain. Эти переменные были сделаны доступными системой отображения форм. Но, что важнее, это переменные, которые вы можете переопределить вызвав form_label() (так как в этом примере вы отображаете ярлык).

Точные переменные доступные для переопределения зависят от того, какую часть формы вы хотите отобразить (например, ярлык или виджет), и какое поле вы отображаете (например,виджет choice имеет дополнительную опцию expanded). Если вы ознакомитесь и привыкнете к form_div_layout.html.twig, вы всегда сможете увидеть, какие опции у вас есть.

1
2

{# **не** работает - переменные не рекурсивны #}
{{ form_widget(form, { 'attr': {'class': 'foo'} }) }}

1
2
3
4

<label for="{{ form.name.vars.id }}"
    class="{{ form.name.vars.required ? 'required' : '' }}">
    {{ form.name.vars.label }}
</label>

1
2
3
4

<label for="<?php echo $view['form']->get('name')->vars['id'] ?>"
    class="<?php echo $view['form']->get('name')->vars['required'] ? 'required' : '' ?>">
    <?php echo $view['form']->get('name')->vars['label'] ?>
</label>