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

{# відобразити лише повідомлення про помилки, пов'язані з цим полем #}
{{ 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 %}